首页
学习
活动
专区
圈层
工具
发布
社区首页 >问答首页 >您会推荐什么样的在线技术文档系统?

您会推荐什么样的在线技术文档系统?
EN

Software Engineering用户
提问于 2011-01-20 11:08:59
回答 1查看 1.5K关注 0票数 11

目标是建立一个具有以下主要要求的在线文档系统:

  • 将主要用作所有应用程序的最终技术文档的中间阶段(可能永远不会完成:])。它通常是这样使用的:有人有问题,我来解决,然后把修复写下来。现在发生的事情变得难以控制:有人有问题,我解决问题,我和别人都很高兴,但两个月后,另一个人也有同样的问题,没人记得修复是什么。
  • 可以从任何地方访问,运行在apache服务器后面。
  • 用户/组管理,允许只读/读-写/管理访问
  • 格式并不太重要:纯文本可以,wiki风格更好。
  • 便宜还是免费

我的一些想法:

  • 只需在文件共享上或通过ssh提供文件(缺点:与windows不太一致,优点:简单,可以是任何文件类型)
  • 将其保存在SCM中(svn/git,同上,但更容易访问和控制访问)
  • 汇合点:我们已经使用了吉拉,合流值得吗?它是如何与吉拉结合的?
  • 还有别的吗?

请不要犹豫评论这些或分享您的经验与其他系统。

EN

回答 1

Software Engineering用户

回答已采纳

发布于 2011-01-20 11:15:45

我本打算建议一个Wiki

由于Confluence是一个wiki,我认为与您的JIRA一起使用它是一个很好的主意。您的优势是能够直接绑定到JIRA问题,因此实际的代码/doc/任何更改等等。

像这样的任何代码文档回购的关键是导航方面。你不希望网页是断开的,很难找到等等。做一个“网站布局”的想法,就像你会为一个网站。

票数 11
EN
页面原文内容由Software Engineering提供。腾讯云小微IT领域专用引擎提供翻译支持
原文链接:

https://softwareengineering.stackexchange.com/questions/38368

复制
相关文章

相似问题

领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档