How does everyone feel about documenting your code and projects. Is it necessary for companies? Do you like it or is it busywork?
For further actions, you may consider blocking this person and/or reporting abuse
How does everyone feel about documenting your code and projects. Is it necessary for companies? Do you like it or is it busywork?
For further actions, you may consider blocking this person and/or reporting abuse
Top comments (7)
I think it's really important write the right documentation. I think self explaining code is a myth If you go beyond simple tutorials or basic scripts. That beeing said my opinion in how to document best is still forming.
I don't like writing technical documentation. The thing is, I like debugging and guesswork even less.
As for functional documentation, you basically have two options.
I find writing docs less tedious since I started blogging though. There are plenty of tools that make it very simple. Especially software like JSDoc, Docusaurus and Obsidian.
What kind of things are you writing documentation for? I can't really recall writing much in the way of documentation at all over more than 25 years developing professionally - in the smallest, right up to large companies.
I'm not just being devil's advocate here... I'm genuinely curious
Just more curious to get a sense of how folks feel about documentation. My assumption it is something we all have to do, but I am wondering if my assumption is wrong.
Documentation in general and documentation of the code is kinda different to me.
For a project it actually can be very important and for code it depends on what you want to document, because if it is about explaining what the code does, I would try to avoid doing it.