TE
TechEcho
Home24h TopNewestBestAskShowJobs
GitHubTwitter
Home

TechEcho

A tech news platform built with Next.js, providing global tech news and discussions.

GitHubTwitter

Home

HomeNewestBestAskShowJobs

Resources

HackerNews APIOriginal HackerNewsNext.js

© 2025 TechEcho. All rights reserved.

Ask HN: How does your organization handle documentation?

6 pointsby niklearnstodevover 3 years ago
It seems useful to get a sense of how different organizations handle documentation in the real world. I&#x27;m curious whether your org uses the following types of documentation (or any others) and how they manage it, with whatever details you can give:<p>-Developer setup<p>-Developer best practices &amp; style<p>-Product documentation<p>-Project documentation<p>-Docblocks&#x2F;doc strings<p>-Inline comments<p>More importantly, what are the habits that your org encourages around documentation?

1 comment

niklearnstodevover 3 years ago
My org (small but growing team, web) manages developer setup, product and project documentation in Notion, and the docs often get created but not maintained, and the product documentation is mostly for recently developed segments of the app. Commenting is generally avoided in favour of clear, self-documenting code, with more complex methods warranting doc strings. We do not add a comment for every method and their parameters&#x2F;returned values. Inline code is only used for complex segments of code.<p>Overall, I feel that our codebase is well-documented, but our product and projects could use better documentation to help new team members and people seeing a segment of the product for the first time in a while. I&#x27;m unsure as to where this should live, however.