请通过提交PR,随时为提高本内容的质量做出贡献,比如改进代码片段,说明等。如果你觉得有用语和措辞让你感到困惑, 在提交 PR 前,先 open 一个 issue 询问下.
不过,当你选择了为这个仓库贡献内容(不仅仅是拼写纠正),就意味着同意授予我(以及任何未来的出版者)非独占性许可,以便在合适的时候我们可以使用该内容。也许你已经知道了,但是我必须明确声明以确保不会有法律的麻烦。
如果你有任何疑问或者关注点,请确保先在 issue(包括 open 和 close 状态)里面搜一下,把issue尽可能减少。我希望尽可能把我的精力放在写书上。
这本书最终会经过官方编辑,拼写错误将会在那时候被纠正。所以 关于拼写我现在不会太注重.
如果你要因为拼写错误发起 PR , 请考虑将几个小的校正合成一个 PR(通过不同的 commits )。 或者, 暂时不用太在意它们 因为我保证我们到时会统一处理它们。
我能理解,当我们阅读一篇长的 md 文件时,如果没有相关联的链接指向其他章节时,它的体验不是特别好。出于这个原因,你们可能觉得可以发起一个 issue/PR 去增加这些功能。
这个话题被提起过很多次,我也考虑过,但我 不 接受这些改变合到仓库。
我的书的仓库主要目的是为了对出版(付费的电子书和印刷版本)进行内容的管理和追踪。我把它公开,是因为我同样在意提供一个免费并且可以提早获得内容的途径,以确保不会因为付费的壁垒阻碍学习。
所以, 这个仓库 不是用来优化你的阅读体验的 。而是用来优化出版流程的。
对你们大多数人而言,最合适的阅读体验就是我(最终)出售的电子书或者印刷版本。提供免费的内容,但是付费的阅读体验,这是我着重的平衡点。对于平衡点其他作者可能有不同的想法,但这是我现在选择的。
我希望你们从内容里面获益,同时希望你们觉得通过购买电子/印刷书(一旦可以销售)来获得最好的阅读体验是值得的。