代碼貢獻(xiàn)指南

很高興你對Matermost open source project感興趣。為了幫助翻譯秤茅,請參閱本地化過程彻秆。 對于代碼貢獻(xiàn),這里是過程:

1 選擇一個(gè)Ticket

  1. Help Wanted GitHub問題列表中選擇一個(gè)ticket蛇耀。
  2. 在開始工作之前,comment讓人們知道你正在處理這個(gè)問題纺涤。
  3. 如果您有任何問題译暂,請將其發(fā)布到Mattermost forum或加入Contributors頻道,并宣布您想要處理的故障單撩炊,以便將其分配給您外永。

歡迎沒有ticket的輕微更正和改善的Pull requests

如果對現(xiàn)有行為的改動(dòng)較小,少于20行的代碼更改拧咳,則可以提交一個(gè)缺陷或增量改進(jìn)的PR伯顶,不需要Help Wanted ticket。 所有提交的沒有相應(yīng)標(biāo)簽的請求將首先由核心團(tuán)隊(duì)產(chǎn)品經(jīng)理審核。 一些小的更正和改進(jìn)的例子包括:

較大的pull request砾淌,包括需要修改文檔或用戶期望的請求啦撮,需要核心團(tuán)隊(duì)打開Help Wanted,以便測試汪厨,記錄和支持更改赃春。
與核心團(tuán)隊(duì)討論opening a Help Wanted ticket的最佳方法是在the feature idea forum中開始對話

2 安裝Mattermost并設(shè)置你的Forks

一旦你有ticket:

  1. 按照developer setup instructions說明安裝Mattermost劫乱。
  2. 在您的mattermost-server或mattermost-webapp repository中創(chuàng)建一個(gè)分支织中,并使用以下命令將<branch name>設(shè)置為正在使用的ticket的ID,例如PLT-394git checkout -b <branch name>
  3. 看看developer flow衷戈,了解如何使用Mattermost代碼庫狭吼。

3 準(zhǔn)備Pull Request

在提交poll request(PR)之前,請檢查:

  • 您已經(jīng)簽署了Contributor License Agreement殖妇,因此您可以將其添加到Mattermost Approved Contributor List中刁笙。
  • 你有一個(gè)用于改善代碼的Help Wanted ticket
  • 你的代碼遵循Mattermost Style Guide,你已經(jīng)運(yùn)行了make check-style來檢查樣式錯(cuò)誤谦趣。
  • 包括新的服務(wù)器端功能的單元測試疲吸。
  • 用戶界面中的字符串包含在i18n/en.json服務(wù)器和webapp i18n/en.json本地化文件中。其他語言的文件將通過Mattermost Transtation Server自動(dòng)更新前鹅,不需要包含在拉取請求中摘悴。
  • 變化符合Fast, Obvious, Forgiving的用戶體驗(yàn)指南。
  • 如果更改要求用戶理解新的概念或做出決定舰绘,PR幫助文檔將提交給mattermost/docs蹂喻。
  • 改變經(jīng)過徹底的測試。如果您的更改涉及到文本處理捂寿,請確保在提交PR之前至少在/tests中運(yùn)行降級測試口四。運(yùn)行l(wèi)oadtests:
    • 轉(zhuǎn)到System Console > Developer并將Enable Testing Commands設(shè)置為true
    • 運(yùn)行/test url test-markdown-basics.md并按照說明操作
    • 運(yùn)行/test url test-markdown-lists.md并按照說明操作
    • 運(yùn)行/test url test-tables.md并按照說明操作
  • 確認(rèn)你squashed your commits

4 提交Pull Request

提交PR時(shí)者蠕,請檢查:

  1. PR is submitted against master
  2. PR標(biāo)題以Jira Ticket ID開頭(例如PLT-394:見examples
  3. PR comment描述了這些變化以及該功能應(yīng)該如何工作
  4. 多個(gè)存儲庫中的多個(gè)相關(guān)PR必須在說明中包含它們之間的依賴關(guān)系窃祝。

5 管理一個(gè)Open Pull Request

提交PR后,合并之前:

  1. 自動(dòng)構(gòu)建過程必須通過
    • 如果構(gòu)建失敗踱侣,請檢查錯(cuò)誤日志以縮小原因粪小。
    • 有時(shí),由于Travis CI中的問題抡句,多個(gè)構(gòu)建測試中的一個(gè)將會隨機(jī)失敗探膊。 如果您只看到一個(gè)構(gòu)建失敗并且沒有明確的錯(cuò)誤消息,則可能是一個(gè)隨機(jī)問題待榔。 添加評論逞壁,以便更改的審閱者可以重新運(yùn)行構(gòu)建流济,或者關(guān)閉公共關(guān)系并重新提交,通常會清除問題腌闯。
  2. PM審查必須通過
    • 產(chǎn)品經(jīng)理將檢查pull request以確保:
    • 產(chǎn)品經(jīng)理可能會回來一些錯(cuò)誤或用戶界面的改進(jìn)來解決之前拉動(dòng)請求移動(dòng)開發(fā)審查绳瘟。
  3. CSS審查必須通過
    • 任何包含CSS更改的pull request都應(yīng)該由UX和HTML/CSS開發(fā)人員進(jìn)行審查。
  4. Dev審查必須通過
  • 兩個(gè)核心提交者將審查拉取請求姿骏,并提供反饋或批準(zhǔn)公關(guān)糖声。
  • 在拉取請求準(zhǔn)備合并之前,需要解決任何注釋分瘦。

如果您的郵寄地址包含在注冊的Contributor License Agreement中蘸泻,則在您的第一個(gè)拉取請求合并后,您可能會收到一個(gè)限量版Mattermost杯子作為感謝禮物嘲玫。

核心提交者

Mattermost存儲庫上的核心提交者由經(jīng)過審核的核心團(tuán)隊(duì)成員組成悦施,包括社區(qū)貢獻(xiàn)者以及來自Mattermost,Inc.的員工去团,這些人員都值得信賴來審查和合并PR抡诞。

  • 核心提交者包括:Coreyhulen,crspeller渗勘,csduarte沐绒,enahum俩莽,grundleborg旺坠,hmhealey,jwilander
  • 產(chǎn)品經(jīng)理包括:asaadmahmood扮超,esethna取刃,it33,jasonblais出刷,lfbrock
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末璧疗,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子馁龟,更是在濱河造成了極大的恐慌崩侠,老刑警劉巖,帶你破解...
    沈念sama閱讀 219,366評論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件坷檩,死亡現(xiàn)場離奇詭異却音,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)矢炼,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,521評論 3 395
  • 文/潘曉璐 我一進(jìn)店門系瓢,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人句灌,你說我怎么就攤上這事夷陋。” “怎么了?”我有些...
    開封第一講書人閱讀 165,689評論 0 356
  • 文/不壞的土叔 我叫張陵骗绕,是天一觀的道長藐窄。 經(jīng)常有香客問我,道長酬土,這世上最難降的妖魔是什么枷邪? 我笑而不...
    開封第一講書人閱讀 58,925評論 1 295
  • 正文 為了忘掉前任,我火速辦了婚禮诺凡,結(jié)果婚禮上东揣,老公的妹妹穿的比我還像新娘。我一直安慰自己腹泌,他們只是感情好嘶卧,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,942評論 6 392
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著凉袱,像睡著了一般芥吟。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上专甩,一...
    開封第一講書人閱讀 51,727評論 1 305
  • 那天钟鸵,我揣著相機(jī)與錄音,去河邊找鬼涤躲。 笑死棺耍,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的种樱。 我是一名探鬼主播蒙袍,決...
    沈念sama閱讀 40,447評論 3 420
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼嫩挤!你這毒婦竟也來了害幅?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,349評論 0 276
  • 序言:老撾萬榮一對情侶失蹤岂昭,失蹤者是張志新(化名)和其女友劉穎以现,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體约啊,經(jīng)...
    沈念sama閱讀 45,820評論 1 317
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡邑遏,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,990評論 3 337
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了棍苹。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片无宿。...
    茶點(diǎn)故事閱讀 40,127評論 1 351
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖枢里,靈堂內(nèi)的尸體忽然破棺而出孽鸡,到底是詐尸還是另有隱情蹂午,我是刑警寧澤,帶...
    沈念sama閱讀 35,812評論 5 346
  • 正文 年R本政府宣布彬碱,位于F島的核電站豆胸,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏巷疼。R本人自食惡果不足惜晚胡,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,471評論 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望嚼沿。 院中可真熱鬧估盘,春花似錦、人聲如沸骡尽。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,017評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽攀细。三九已至箫踩,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間谭贪,已是汗流浹背境钟。 一陣腳步聲響...
    開封第一講書人閱讀 33,142評論 1 272
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留俭识,地道東北人慨削。 一個(gè)月前我還...
    沈念sama閱讀 48,388評論 3 373
  • 正文 我出身青樓,卻偏偏與公主長得像鱼的,于是被迫代替她去往敵國和親理盆。 傳聞我的和親對象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,066評論 2 355

推薦閱讀更多精彩內(nèi)容

  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理凑阶,服務(wù)發(fā)現(xiàn),斷路器衷快,智...
    卡卡羅2017閱讀 134,668評論 18 139
  • 多種多樣的工作流使得在項(xiàng)目中實(shí)施Git時(shí)變得難以選擇宙橱。這份教程提供了一個(gè)出發(fā)點(diǎn),調(diào)查企業(yè)團(tuán)隊(duì)最常見的Git工作流蘸拔。...
    JSErik閱讀 4,409評論 2 8
  • 宇彤老師第三期開營了:通過昨晚的學(xué)習(xí)师郑,開始反思自已的發(fā)音、吸氣调窍、呼氣.......開始慢慢體會美麗智慧的宇彤老師"...
    云淡風(fēng)輕一閱讀 198評論 0 0
  • 隨著公司團(tuán)隊(duì)的不斷擴(kuò)張與年輕化宝冕,大多數(shù)管理者會遇到這樣一個(gè)問題——如何管理 90 后員工? 許多人給 90 后打上...
    東萊山人閱讀 521評論 0 2
  • 這幾天不知道咋回事看同事特別不順眼邓萨,對待工作極其不負(fù)責(zé)任地梨,總是喜歡拖菊卷,一直到不得不做了才火急火燎的去完成。...
    我心翱翔閱讀 199評論 0 1