Thoughtworks洞见
·
如何编写技术文档？
💡
原文中文，约2800字，阅读约需7分钟。
📝
内容提要
软件开发中编写文档很重要，但很少有关于正确组织技术文档的实践方法。文档应该具有清晰的结构，可以使用结构化文档或图谱化文档。选择文档构建方案时要考虑需求和非功能性需求。推荐使用sphinx + 文档象限 + Git或logseq作为知识库。Google Doc/Confluence也是选择，但需要手动管理存档备份。结构化文档组织方式更可靠，图谱化文档需要慎重选择。
🎯
关键要点
- 软件开发中编写文档的重要性
- 文档组织的挑战与混乱结构问题
- 两种文档组织方式：结构化文档与图谱化文档
- 结构化文档的优势与文档象限的应用
- 图谱化文档适合知识生产与管理
- 文档构建工具的选择与非功能性需求
- 推荐的文档构建方案：sphinx + 文档象限 + Git
- logseq作为知识库的优缺点
- google doc/confluence的协作优势与缺点
- 总结：结构化文档与图谱化文档的选择
➡️
