FAQ - 常见问题答疑

本节主要整理一些常见问题,如『如何贡献』、『有疑问如何讨论』和授权协议等。

能说一下项目的背景吗?

最开始的维护者为 @billryan, 由于他在学习算法的过程中需要使用 markdown 记录自己的学习心得,正好发现 Gitbook 很好地满足了他对使用 markdown 写技术笔记的所有幻想。

在网页上发现有错误的地方怎么办?

有两种相对轻量级一点的方式:disqus 评论和 GitHub 的 Web 界面更改。markdown 标记语言简明清晰,不会成为贡献内容的障碍。

最简单的方式是通过网页最上方的『改进此页』在 GitHub 的 Web 界面上更改并提交 Pull Request. 也许你之前并没有 git 相关经验,没关系,下面的截图视频教你怎么玩儿。

Pull Request in the GitHub Web

总结下来就是:

  1. 点击『改进此页』
  2. 跳转至 GitHub 登陆界面认证后在 Web 上更改你觉得有问题的地方
  3. 改好后在下方的 comment 处简要说一下更改的理由
  4. 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-exerciseGitbook 渲染生成 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 金额随意

Wechat

Red Packet

金额随意

PayPal

账户名:yuanbin2014(at)gmail.com 金额随意,付款时选择 friends and family