参与开源的一个好方法是为您当前正在从事的(开源)项目做出贡献。Github为多达500万个开源项目提供托管服务。有针对各种技术集的项目,例如:食谱、HTML/CSS、Ruby、天体物理学等等。本指南将涵盖典型项目的各个方面以及如何做出贡献。查找项目我们建议您首先查找您已经使用(或感兴趣)的项目。以下是一些值得访问的链接:GitHubExplore:当前热门项目和有前途的项目。GitHubStars:由他人评分的项目排行榜。GitHubShowcases:查找相关存储库。LayerVault新闻:前端和设计项目。典型项目以下是开源项目中可能访问的一些元素。社区项目通常有一个社区,由其他不同角色的用户创建:所有者是项目创建者或其组织,账户身份拥有该项目。维护者和协作者是项目的主要开发者,也是负责引导项目发展方向的人。通常项目所有者和维护者是同一个人。他们对存储库具有写入权限。贡献者是对项目进行拉取并将其合并到项目中的任何人。社区成员是该项目的常客,非常关心该项目,并积极讨论该项目的特性和拉取请求。文档项目自述文件中包含的常用文档文件几乎Github上的所有项目都包含一个README.md文件。本自述文件描述了项目的使用、编译,有时还提供了项目参与的详细地图。参与文档(Contributing)不同的项目和项目维护者不同,因此参与项目的方式也不同。您可以关注名为CONTRIBUTING的文档。参与文档详细说明了项目维护者希望看到修补和贡献的功能规范。这可能包括测试的编写方式、编码风格或补丁的应用范围。许可证(License)LICENSE文件是项目的许可证描述文件。一个开源项目的许可证告诉用户他们可以做什么和不能做什么(例如:使用、修改和分发),以及贡献者的权利。该文档告诉其他人他们可以做什么。有很多方法可以许可和分发开源项目,您可以在这个站点找到不同许可的含义:choosealicense.com.documentation和wiki许多大型项目跳过自述文件来指定用户如何使用他们的项目,在这种情况下你通常有你会发现一个链接或一个名为“docs”的文件夹。另外,仓库也可以使用Github的wiki系统代替文档。参与项目现在您已经找到了理解项目的材料,开始工作吧。创建问题如果您在项目中发现错误(但您不知道如何修复它),无法在文档中找到有关它的信息或对项目有疑问-创建问题!无论您的问题是什么或您现在有什么问题,您可能不是唯一有疑问的人,其他用户可能会从您的问题中获得帮助。此外,有关问题如何运作的更多信息,请查看我们的问题指南。问题专业建议检查当前问题是否与您相关。发布重复问题会降低双方的效率。搜索打开和关闭的问题以检查您当前提出的问题是否已被提及。请澄清您的问题:预期输出是什么以及实际发生了什么?以及其他人如何重现您的问题。示例链接:重现问题的方法,例如提供jsfiddle和codepen上示例的链接。报告系统环境的详细信息。例如使用什么浏览器、使用的库或操作系统的版本。将错误输出或日志粘贴到您的问题或Gist中。如果您将错误输出或日志粘贴到问题中,请使用三重反引号```使其看起来更好。如果您有能力自己修复错误或添加新功能,则拉取请求非常有用。向代码库发出拉取请求!确保您已阅读参与文档、了解许可证并拥有已签名的CLA(如果需要)。一旦你提交了pullrequest,项目的维护者就可以将你的分支与当前分支进行比较,以决定是否合并(pullin)你的更改。PullrequestprofessionaladviceFork存储库并在本地克隆它。通过将您的本地连接到原始的“上游”存储库并将其标记为远程连接。经常从“上游”拉取更改可确保最新版本在提交拉取请求时是最新的,从而减少合并冲突的可能性。可以在此处找到详细说明。为您的编辑创建一个分支。了解问题是如何发生的以及其他人如何重现问题或您提交的功能会很有帮助。同样,清楚地了解您的变更实施步骤。最好测试一下。如果是这样,请针对现有测试项目测试您的更改,如果需要则创建一个新测试。无论是否存在测试,请确保您的更改不会破坏现有项目。提供更改前后的屏幕截图,包括html/css中的差异,并将图像拖放到您的拉取请求中。尽量参考项目风格参与项目。这包括使用缩进、符号和注释,可能在你的项目中使用方式不同,但使用(与项目的风格一致)会让项目维护者更容易合并,也更容易让其他人在以后理解和维护。打开拉取请求一旦您打开拉取请求,就会开始讨论您提交的更改。其他参与者和用户将参与其中。但最终由维护者做出决定。您可能会被要求对您的拉取请求进行更改,如果是这样,请向您的分支添加更多评论并推送它们——它们将自动加入现有的拉取请求。如果您的拉取请求被合并-太好了!如果没有,那也没关系,也许项目的维护者没有注意到,或者他们已经对此做了一些事情。此时,我们建议接受您收到的反馈并对其进行处理,提交另一个拉取请求——或创建您自己的开源项目。原文链接:github翻译:伯乐在线-周长红翻译链接:http://blog.jobbole.com/65147/
