我在加拿大安大略省滑铁卢的质量工程部工作。有很多关于我们如何工作的信息，包括内部和外部。例如，内部有JAM、SharePoint和Wiki，spark大数据，外部使用Google、Stack Overflow和其他技术站点。有这么多的站点要导航，我想把信息存储在一个中心位置会更好，所以我创建了一个信息存储库。它不仅包含了新的内容，而且还引用了所有这些工具的链接。

信息库一开始是作为新员工和实习生的参考点，但现在已经不仅仅是这样了！这是一个分享信息和促进交叉培训的好方法。

在从事用户协助工作一段时间后，我在SAP Cloud Platform SDK for Android上工作，看到他们使用了MkDocs。首先，物联网技术应用，我使用MkDocs建立了我们的质量工程文档，但后来转移到了Jekyll.

"MkDocs是一个快速、简单的静态站点生成器，用于构建项目文档。文档源文件是用Markdown编写的，并配置了一个YAML配置文件。"有关更多信息，请参阅MkDocs网站。

Jekyll简单、静态，大数据是数据，是一个很棒的博客工具。它也用于建设项目和技术文件。有关更多信息，请参阅Jekyll网站。

MkDocs和Jekyll都会将markdown和yaml文件转换为HTML。它们都可以很容易地集成到GitHub中，合肥大数据，您可以使用GitHub页面来托管文档。

我想讨论每个项目文档工具的优点和缺点。

MkDocs

Jekyll

对我来说，没有"编辑我"是一个大问题，因为我希望它尽可能容易地进行更改。此按钮允许用户编辑当前页面并进行必要的更改，而无需转到GitHub来确定页面的位置。当时，"编辑我"去的是项目，而不是页面。这一点已经得到纠正。

编辑我

我决定与杰基尔主要是为了"新的外观和感觉"和能力，有人编辑一页。它花了更长的时间来设置，大数据分析系统，但一旦完成，我很高兴我和杰基尔去！团队中的人几乎每天都在添加内容。以下是质量工程文档的登录页：

QE文档

我的下一步是使用Docker，因为有现成的Jekyll Docker图像。