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