我试着比较了设计书的创建和管理工具(Gitbook、Growi和Confluence)
为了理解这个问题
比较并选择适合的工具来创建和管理个人开发应用程序的设计文档。另外,要注意以下几点:
– 不依赖于诸如Excel等软件,而是可以使用标记语言进行描述的工具。
– 使用和引入成本较低的工具(实际支付的费用和相关信息是否可供参考)。
比较过的物品。
经过调查,以下三个选项成为了我们的考虑对象:
1. GitBook
2. Growi
3. Confluence
概括而言
如果是个人开发的话,我认为Gitbook或者Growi两个选项都足够了。
由于能够使用的功能几乎相同,所以决定要根据图像贴附的便利性以及环境设置(仅使用Node.js还是Node.js与MongoDB)来选择使用哪个。
Confluence似乎被认为是更适合大型团队使用的管理工具。
我将介绍根据我的调查所得到的优点和缺点(利与弊)。
Gitbook 可以在一個平台上與他人合作,輕鬆地撰寫、編輯和發布書籍。
我认为这是一个类似于能通过Git进行管理的书籍的应用的名称。(从开发者的角度来说与Github没有关系。)
看起来不错的地方:
– 免费
– 可以使用Markdown进行编写
– 可以设置目录(层次化似乎很容易)
– 可以将.md转换为.html,然后将其上传到Github存储库中,通过Github Pages进行发布
– 可以通过插件进行UML、图表等描述
– 默认情况下可以对文章进行全文搜索
看起来不太好的地方:
– 无法导出为pdf
– 虽然有CLI,但维护似乎已停止(据说)
所需的操作环境
– Node.js
我正在参考以下文章。
成長
似乎有优点的地方:
– 免费
– 可以使用Markdown编写
– 可以添加目录(层次化似乎很容易)
– 可以捕捉到差异
– 运行速度很快(似乎如此)
– 可通过插件进行UML描述
– 可以默认全文搜索文章
– 编写表格很容易
– 将图像粘贴很容易
– 环境设置很简单
似乎不太好的地方:
– 打印困难
– CLI存在,但维护已停止(似乎如此)
需要的操作环境:
– Node.js
– MongoDB
汇合
以下是一种可能的中文表达方式:
看起来不错之处:
– 免费(最多可容纳10个用户)
– 可用的模板似乎很多
微妙的地方
– 資料不足。
最后
我打算根据结论的内容试用Gitbook或者Growi。我觉得这两者都很容易安装,所以试用一些后再做决定吧。
看到下面的文章后,例如在之后的维护过程中需要使用其他人的时候,是不是使用Gitbook比较好呢?但是由于是用Markdown编写的,所以我也想着使用Growi应该也能解决一些问题。
https://qiita.com/KeitaMoromizato/items/04ac6058010248b3ce82