Meteor 英文文档评注计划

[JimmyLv]

围绕 GitHub 学习进阶

一般的 English 文档都支持 GitBook，哪怕不支持我就手动生成一下 GitBook，所以我就可以 Download 下来 Push 到自己的 GitBook，然后在 GitBook 上进行评注，产生的评注会自动生成 Issue（或可以实现同步至GitHub？）。

学习目的：记录下自己的问题，并且持续跟进，搞懂过后就可以归档，即 Close 掉了。

工具集

• GitBook 一系列插件，Best gitbook modules for Node.js - Pincer.io
• 完美生成 SUMMARY，待试 https://www.npmjs.com/package/gitbook-summary
• ....

[EthanLin-TWer]

啥，评注可以自动生成issue？

[JimmyLv]

@linesh-simplicity 不是会生成 GitBook 的 Issue 么？

参见 https://www.gitbook.com/book/jimmylv/learning-microservices/discussions

[JimmyLv]

比如 Meteor 的文档就有人已经做了 GitBook 的版本，meteor/guide#166

[JimmyLv]

然而！

使用 GitBook 的缺点：

• GitBook 的评注无法同步到 GitHub，我已经提了 Feature request: sync GitBook discussions to GitHub issues · Issue #1456 · GitbookIO/gitbook => HTML <title> for documentation pages GitbookIO/community#114
• GitBook 默认支持的评注只能编辑一行，虽然支持 Markdown 但是只有一行写毛线啊，用的 text 而不是 textarea 标签。
• 重点来了！已经写了的评注竟然不能修改，跟 GitHub 简直差太远了噶！那怎么记录我的想法并且持续更新？

所以，还是改用 Diigo 来评注英文文档吧，参见 #28