如何在Github上為開源貢獻力量？
參與開源的一個好方式是為當前你正在使用的（開源）項目貢獻力量。Github為多達五百萬的開源項目提供托管。這里有各種技術集的項目，比如：recipes、 HTML/CSS、Ruby、Astrophysics和其他許多項目。這份指南會涵蓋在一個典型項目中的各個方面，同時指導如何參與貢獻。
查找項目
我們建議你開始時查找你已經在使用的項目（或者感興趣的項目）。下面是一些值得訪問的鏈接：
- · GitHub Explore: 當前熱門項目和有潛力的項目.
- · GitHub Stars: 項目由他人評價的排行榜.
- · GitHub Showcases: 查找相關的倉庫.
- · LayerVault News: 前端和設計項目.
一個典型的項目
下面是在一個開源項目中可能會訪問的一些元素。
社區
項目通常都含有一個圍繞它的社區，由其他不同角色用戶創建：
- 所有者是項目創建者或其組織，該賬戶身份擁有這個項目。
- 維護者和協作者是一個項目的主要開發者和負責駕馭項目開發方向的人。通常項目所有者和維護者是同一個人。他們擁有倉庫的寫權限。
- 貢獻者是指任何對項目進行pull操作并合并到項目中的人。
- 社區成員是經常使用項目的用戶，深切關心項目并且活躍討論項目的特性和pull請求。
文檔
項目中包含的通用文檔文件
請讀我（Readme）
幾乎所有Github上的項目都包含一個README.md文件。這個Readme描繪了項目使用、編譯，有些時候也提供項目參與的詳細地圖。
參與文檔（Contributing）
不同項目和項目的維護人員存在差異，所以參與項目的方式也不同。你可以關注一個叫CONTRIBUTING的文檔。參與文檔詳細描述了項目維護人員希望看到補丁和貢獻特性的規范。這可能包含了如何編寫測試，代碼風格或者補丁應用范圍。
許可證（License）
LICENSE文件是項目的許可證說明文件。一個開源項目的許可證告訴用戶他們可以做和不可以做什么（例如：使用，修改和分發），以及參與者的權利，這個文件告訴其他人他們可以怎么做。許可和發布開源項目有許多方式，你可以在這個網站了解不同許可的含義：choosealicense.com.
文檔和wiki
許多大型項目略過Readme來指定用戶如何使用其項目，這種情況下你在倉庫中通常會找到一個鏈接或者一個名叫“docs”的文件夾。
另外，倉庫也可以使用Github的wiki系統來代替文檔。
參與一個項目
現在你已經找到理解一個項目的材料了，開始行動起來吧。
創建一個Issue
如果你發現你使用項目中的一個bug（但是你不知道如何去修復它），在文檔中也找不到相關信息或者對項目存有疑問——創建一個issue！不管你的issue什么內容或者你現在有什么issue，你可能不是唯一存有疑問的，其他用戶可能會從你的issue得到幫助。此外，想要更多關于issue如何工作的信息，請查看我們的issue指南。
Issues專業建議
- 檢查當前的issue是否有與你相關聯的。發布重復的issue會讓雙方都降低效率，搜索開放和已經關閉的issue來檢查你現在提出的issue是否已經被提及。
- 請明確你的問題：期望的輸出是什么，實際發生了什么？以及其他人如何復現你的問題。
- 對示例的鏈接：復現問題的方式，比如提供在jsfiddle和codepen上的示例鏈接。
- 匯報系統環境的詳細信息。比如使用什么瀏覽器，使用的庫或者操作系統的版本。
- 在你的issue或者Gist中粘貼錯誤輸出或者日志。如果你粘貼錯誤輸出或日志到一個issue中，請使用三個反引號```使得顯示更漂亮。
Pull請求
如果你自己有能力修復bug或者添加新特性——那就太妙了。對代碼基做一個pull請求！請確保你已經讀過參與相關的文檔了，了解許可證并擁有一個簽名的CLA（如果需要的話）。一旦你提交了一個pull請求，項目的維護人員可以比較你的分支和當前分支來決定是否合并（pull in）你的變更.
Pull請求專業建議
- Fork倉庫并克隆到本地。通過連接你本地到初始的“上游”倉庫并標記作為一個遠程連接。時常從“上游”Pull in變更保證在提交你的pull請求時是最新版本，從而減少合并沖突的可能性。詳細的指導見這里。
- 為你的編輯創建一個分支。
- 清楚問題是如何發生的，同時其他人如何去復現問題，或者你提交的特性是有幫助的。同樣的，清楚了解你的變更執行步驟。
- 最好進行測試。如果有，對已有的測試項目測試你的變更，需要時創建一個新的測試。不管測試是否存在，請保證你的變更不會擾亂現有項目。
- 提供你變更前后的截圖，包括在html/css上的不同，拖拽圖片到你的pull請求中。
- 盡量參照項目風格來參與項目。這包括使用縮進，符號和注釋，也許在你的項目中使用有所不同，不過使用（和項目一致的風格）會讓項目維護人員更容易合并，其他人也更容易理解和在將來進行維護。
打開pull請求
一旦你打開了一個pull請求，一個你提交變更相關的討論就會開始。其他參與者和用戶會參與進來。但是最終還是由維護者進行決策。你可能會被要求對你的pull請求進行修改，如果是這樣，為你的分支添加更多的注釋并push它們——它們會自動加入已經存在的pull請求。
如果你的pull請求被合并了——非常棒！如果沒有，也沒問題，可能項目的維護者并沒有注意到，或者他們已經為此做了一些事情。這時，我們建議你接受你收到的反饋并繼續處理，再次提交pull請求——或者創建你自己的開源項目。
