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

科技回声

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

GitHubTwitter

首页

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

资源链接

HackerNews API原版 HackerNewsNext.js

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

Ask HN: Which are the best resources to document efficiently your projects?

1 点作者 julbaxter超过 5 年前
At work we are using Confluence and GitHub. What to put in Confluence and what to put in GitHub? When to use GitHub wiki vs checked-in documentation? How to deal with information vs knowledge? How to avoid outdated documentation?

1 comment

austincheney超过 5 年前
Put business details in confluence and the technical in Github.<p>Business details:<p>* Product purpose - What it does.<p>* Business justification - Much money it generates or saves the company.<p>* Product Owner<p>* Business alignments&#x2F;dependencies<p>Technical stuff:<p>* Describe what the product actually does, as opposed to what it claims to do.<p>* List all build and installation steps.<p>* Document how to run tests.<p>* Document technical requirements and business flow through the application.<p>* Try to autogenerate the areas of documentation that are most likely to go out of date. I wrote a build step in my Node.js app that does this so I don&#x27;t have to manually maintain a good portion of the documentation.