文档代码化¶
文档代码化是指借鉴代码开发的方式开发文档,这样做有很多优势。
- 代码与文档有机结合。
- 软件工程师也可以贡献部分文档
- 低成本。
Amazon jekyll doc¶
亚马逊的文档也是基于这一套方式开发,代码的可以在 github repo 中找到。
其他几个基于Jekyll开源的文档主题:
- http://bruth.github.io/jekyll-docs-template/
- https://github.com/clojurewerkz/docslate
- https://github.com/tomjoht/documentation-theme-jekyll
- https://github.com/stitchdata/docs#stitch-documentation
更多网站,请见:https://cloudcannon.com/jekyll/2015/06/12/whos-using-jekyll.html