I am that kind of a person who writes the function of each function() in comments above the def.
I hat people who do not do that properly :/
If you are working as a part of a team or wanting to distribute your code, you should do that. :)

  • 0
    @CorruptComputer some people generally don't follow certain standards when naming functions.
    But a comment is always nice. If someone's a newcomer, he/she won't have to look through the code to find out how it's used.
  • 0
    @TktStatusPICNIC these are exactly what I want to see when I see a code from other devs. Good documentation is an integral part of good coding practice.
Add Comment