全球最大同性交友网站 GitHub,汇聚了各种各样优秀的开源项目,包括一些自托管的 (self-hosted) 服务, 许多人初次接触这些项目时往往会眼前一抹黑,不知从何下手。本文这就教你碰到自己不会用的开源项目应该怎么办!

对于本文中提到的概念,都能在仓库的首页找到(除了社群/社区),找不到?使劲找!!!

1、阅读 README 文件

READ ME,正如字面意思“读我”,蕴含了极大的信息量。当你打开一个仓库(项目),文件列表下方往往就会把 readme.md 的内容显示出来。当你看到一个几万 star 的项目却不知道它是做什么的时候,readme 可以解答你的疑问。

2、访问项目官网

你可能可以在仓库的右侧栏顶部找到一个蓝色的链接,这里就是项目的官网。官网是展示一个项目功能,宣传项目的门面,其中往往也包含了文档 (Documents) 指南 (Guide)。这可以教会你你想知道的大多数内容。对于一些常见的问题,作者可能会设置一个 FAQ (Frequently asked questions)Q&A (questions and answers),在提问之前不妨看看这里。

3、善用查找功能

3.1 issue

在 GitHub issue 中搜索,最好用英文,当然,如果一样望去都是中文的话中文搜索也不是不行,记得清空搜索框,否则只搜索仍然开启的 issue!

3.2 discussion

在 GitHub discussion 中搜索,看是否有人问了相同的问题。如果没有,你又确定你不是遇到问题的个例的话,可以在这里提问。

3.3 搜索引擎

去搜索引擎查找!百度没有就用必应、谷歌!

4、在社群/社区询问

在项目交流群里询问一定要注意以下几项:

  • 确保你已经做完前面的几件事了,告诉群友你在哪里查了仍然找不到答案
  • 问具体问题,不要问“为什么用不了”“怎么用”之类的问题,你让别人根本没法回答你
  • 遇到错误描述现象并贴日志!贴日志!贴日志!
  • 有礼貌
  • 如果群友需要你提供某些信息,在不涉及隐私的情况下请尽可能满足对方,你不知道需要哪些信息,别人知道。