FAQ - 常见问题答疑
本节主要整理一些常见问题,如『如何贡献』、『有疑问如何讨论』和授权协议等。
能说一下项目的背景吗?
最开始的维护者为 @billryan, 由于他在学习算法的过程中需要使用 markdown 记录自己的学习心得,正好发现 Gitbook 很好地满足了他对使用 markdown 写技术笔记的所有幻想。
在网页上发现有错误的地方怎么办?
有两种相对轻量级一点的方式:disqus 评论和 GitHub 的 Web 界面更改。markdown 标记语言简明清晰,不会成为贡献内容的障碍。
GitHub Edit Link
最简单的方式是通过网页最上方的『改进此页』在 GitHub 的 Web 界面上更改并提交 Pull Request. 也许你之前并没有 git 相关经验,没关系,下面的截图视频教你怎么玩儿。
总结下来就是:
- 点击『改进此页』
- 跳转至 GitHub 登陆界面认证后在 Web 上更改你觉得有问题的地方
- 改好后在下方的 comment 处简要说一下更改的理由
- Pull Request
不要告诉我你没有 GitHub 账号...
Disqus
如果你实在是不想在 GitHub 的 Contributor 处青史留名,那就通过这种方式吧!Maintainer 稍微辛苦点就是... 另外你也可以通过 Disqus 在相应网页下提出你的疑问。 disqus 的评论处直接粘贴代码十分难看,参考 syntax highlighting 改进。
我想成为重量级贡献者!
不要犹豫!快到碗里来!猛戳 贡献指南
有暂时没出现在网页上的问题怎么办?
有两种方式:GitHub issues 和 Slack. 你可以加入 Slack 群 - http://slackin4ds-algo.herokuapp.com 和我们一起讨论。
如何订阅更新的内容?
本项目托管在 https://github.com/billryan/algorithm-exercise 由 Gitbook 渲染生成 HTML 页面。
你可以在 GitHub 中 star 该项目手动查看更新,也可以订阅 https://ds-algo.slack.com/messages/github_commit/ 中的 #github_commit
channel 在邮件中查看更新细节,RSS 种子功能正在开发中。
Slack 的自助邀请注册功能已启用,访问 http://slackin4ds-algo.herokuapp.com 即刻开启~
Gitbook 虽然也有 star 和 subscribe 功能,但目前来看还是非常鸡肋,通过 Slack 的 #github_commit
channel 你可以看到对单文件diff
级别的改动。
号外:Slack 的 shua-shua-shua channel 用于刷题小组讨论,大家可以在这个 channel 里一起讨论学习算法。
我觉得这个文档整理的真好,接受捐助吗?
当然!除了 GitHub 上 star 或者帮助改进内容外,你还可以以现金或者其他实物激励我们创造出更好的内容!
邮寄明信片
@billryan 喜欢收集各种明信片,来者不拒~ 邮寄的话可以邮寄至 上海市闵行区上海交通大学闵行校区电院群楼5号楼307
,收件人:袁斌
。
送书
除了邮寄明信片,你还可以买本书送给各位贡献者,@billryan 的地址见上节。
支付宝
账户名:yuanbin2014(at)gmail.com 金额随意
金额随意
PayPal
账户名:yuanbin2014(at)gmail.com 金额随意,付款时选择 friends and family