TE
科技回声
首页24小时热榜最新最佳问答展示工作
GitHubTwitter
首页

科技回声

基于 Next.js 构建的科技新闻平台,提供全球科技新闻和讨论内容。

GitHubTwitter

首页

首页最新最佳问答展示工作

资源链接

HackerNews API原版 HackerNewsNext.js

© 2025 科技回声. 版权所有。

Ask HN: How does your organization handle documentation?

6 点作者 niklearnstodev超过 3 年前
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

niklearnstodev超过 3 年前
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.