我试着比较了设计书的创建和管理工具(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