2

Documentation 😭is the lest fun part of the development cycle

Comments
  • 1
    But it is necessary in my opinion. Thoughts?
  • 0
    For a personal project ,I don't think it's necessary,but for a work project,documentation is very important
  • 3
    2k lines and 3 months later, you'll thank yourself for putting down a few notes here and there
  • 0
  • 1
    It's necessary not to "overcomment" too, yesterday I found a code in production which was basically returning true if x == y.

    The code in three methods was 464 characters, (Don't ask me why or how) while comments on this "functionality" where 480 characters.
  • 2
    i like to write it with myself a few years back in mind. Me years ago was (is still) a total noob
  • 1
    speaking from experience as someone who spends a lot of time documenting everything (including every one else's code) only to have none else read it... its still worth it...always think of future self first and foremost. also I'd recommend confluence - beautiful for documentation - especially if you're already drinking the atlassian coolaid.
  • 1
    when I develop packages for r ( a statistical language) documentation is always part of the work. in most IDEs a shorcut lets you insert a framework of that describes the function, arguments and so forth. however for more in depth documentation you really need to do it yourself.
  • 1
    I like the idea of first writing comments and steps and then writing the code
  • 1
    @Charmgoggles to be honest I prefer do first write tests ;)

    Your approach might be ok if you have thought out every little aspect of your code. Even then is very likely that your code will change, therefore some of your comments will become irrelevant or wrong, and it is better (IMHO) to have no comments than misleading comments.
Add Comment