COMMIT-COMMENT和合模式紀(jì)要
**小組:GS07E15gDAMA **
特別鳴謝:
ZoomQuiet 引領(lǐng)Github入門鳄橘,并以豐富的經(jīng)驗(yàn),監(jiān)督整個(gè)和合探索流程惩嘉,引導(dǎo)并鼓勵(lì)正確的探索思路,一票否決錯(cuò)誤的思路,避免小組走上耗費(fèi)時(shí)間且無效的彎路纹份。
安心竹 以細(xì)膩的才思,和接地氣的實(shí)干精神廷痘,四兩撥千金蔓涧,想出在新版本commit前,將不需要修改的行直接做空格處理的方式笋额,節(jié)省一個(gè)專門用來空格,使可comment的新版本元暴,賦予split對(duì)比視圖在c-c模式中的有效意義。
一坪海岸線 最早提出空格說兄猩,為commit-comment模式的整體系統(tǒng)提供極其重要的啟發(fā)思路茉盏,并且獨(dú)立研發(fā)會(huì)議錄音上傳機(jī)制,以穩(wěn)重的思路枢冤,凝聚并感染著全體小組成員鸠姨。
申小七 以極其勤奮的態(tài)度,帶動(dòng)并加速了全小組的和合節(jié)奏淹真,以放棄客戶也要參加互懟會(huì)議的精神讶迁,成功把我們牢牢拽進(jìn)語音會(huì)議室,以怎么懟都不生氣核蘸,還會(huì)加倍努力懟回來的求知若渴巍糯,成功帶著小組奔向和合大法。
以下值纱,是和合技commit-comment模式的系統(tǒng)流程和小組規(guī)約
#commit-comment和合模式解決的核心需求
一覽無余
對(duì)多人和合建議的一覽無余
對(duì)所有歷史成稿(非版本)的一覽無余
#commit-comment和合模式綜述:
階段性凍結(jié)edit功能鳞贷,所有成員使用commit界面,利用comment功能虐唠,對(duì)同一篇或多篇文章發(fā)表評(píng)論的和合模式搀愧。
#commit-comment 和合模式操作精要
在code中新建topic,發(fā)布初始文件,此為第一稿咱筛,發(fā)布者為第一作者搓幌。
commit 界面:打開commit 界面,第一稿發(fā)布后的初始狀態(tài)迅箩,可以多人逐行comment. 請(qǐng)所有小組成員使用commit界面溉愁,針對(duì)第一稿逐行發(fā)表comment,此為第一輪comment
在第一輪comment進(jìn)行中饲趋,全體小組成員拐揭,包括第一稿的第一作者,不得使用edit功能修改第一稿奕塑,不得更新版本堂污。
小組決議結(jié)束第一輪comment 的時(shí)間節(jié)點(diǎn)。此處應(yīng)該輔助以語音會(huì)議龄砰,第一作者需對(duì)comment進(jìn)行反饋盟猖,或者第一作者在close comment 前回復(fù)所有comment,有來有往有交流才是真和合.
第一輪close comment 后换棚,第一作者可以根據(jù)所有comment式镐,使用edit功能修改第一稿,注意在此環(huán)節(jié)固蚤,修改過后不能直接點(diǎn)擊commit娘汞。
接第五環(huán)節(jié),正文修改完畢后夕玩,要將每一行前面价说,輸入一個(gè)空格》绯樱空格全部輸入完畢后,確認(rèn)正文仍然左對(duì)齊扮叨,然歐點(diǎn)擊commit缤弦,形成第二稿。
第二稿完成后彻磁,可開始進(jìn)行第二輪comment碍沐。小組成員點(diǎn)擊第二稿的github代碼后,將進(jìn)入第二稿的commit界面衷蜓。
split視圖:commit界面分為unitied 視圖和split 視圖累提。完成第二稿后,打開split視圖磁浇,我們會(huì)清晰地看出斋陪,結(jié)合第一輪comment,第一作者做了哪些修改,即第一輪和合成果无虚。
在第二輪comment中缔赠,我們統(tǒng)一采用split對(duì)比視圖,針對(duì)右側(cè)最新版本(也就是第二稿正文)友题,逐行發(fā)表comment嗤堰,即第二輪comment內(nèi)容。
#commit-comment和合模式邏輯內(nèi)因
在github“版本”概念基礎(chǔ)之上度宦,commit-comment和合模式提出整合多個(gè)“版本”的“成稿”的概念踢匣。即,通過時(shí)階性禁用edit功能戈抄,用更佳清晰的comment功能來記錄和合過程离唬。避免github形成無效的新版本,將修改版本“隱藏”化呛凶,形成更層次分明的“成稿”迭代男娄。類似photoshop中的合并圖層,跨越歷史記錄的時(shí)序漾稀,強(qiáng)調(diào)經(jīng)過和合之后模闲,文章當(dāng)下的整體效果。如果沒有此成稿概念崭捍,很難再github中對(duì)版本進(jìn)行分類分層.(貌似blame功能是做這個(gè)的尸折,但是遠(yuǎn)沒有分輪comment,定時(shí)edit形成的成稿迭代清晰)
github強(qiáng)調(diào)歷史記錄的時(shí)序殷蛇,故每一次修改都形成一個(gè)新的版本实夹,按照時(shí)間順序排列。但是好中文的多人和合粒梦,不強(qiáng)調(diào)comment的時(shí)序亮航,強(qiáng)調(diào)comment的有效信息量。好中文強(qiáng)調(diào)第一作者對(duì)多人建議的一覽無余匀们,不需要針對(duì)每條comment即時(shí)反饋缴淋。
github的設(shè)計(jì)目標(biāo)對(duì)象是程序員,設(shè)計(jì)邏輯是泄朴,強(qiáng)調(diào)對(duì)變更的再修改重抖。
split視圖只能對(duì)比最新兩個(gè)版本,無法對(duì)比歷史版本祖灰。
#commit-comment 和合模式誕生的起點(diǎn)
打開一個(gè)文章的github代碼鏈接钟沛,進(jìn)入其commit界面。如果這不是這篇文章的初始形態(tài)局扶,第一修改人已經(jīng)對(duì)其進(jìn)行edit恨统,那么在commit界面叁扫,第二修改人只能針對(duì)第一修改人的變更進(jìn)行評(píng)論。這不符合好中文和合“一覽無余”的協(xié)作目標(biāo)延欠。
#commit-comment和合模式的替代品
1.針對(duì)誕生起點(diǎn)中提出的問題陌兑,其實(shí)還有第二條可行的解決路徑,即[edit-引用語法]模型由捎。
2.此模型的操作流程兔综,即忽略commit界面(包括unitied和split),完全采用edit界面狞玛。
3.在edit界面软驰,眾人將修改意見以引用語法寫入,并署名心肪。使得意見可以同正文區(qū)分開锭亏。
4.以[edit-引用語法]模式,若完全放棄commit界面硬鞍,所以多版本干擾等也都不是問題慧瘤,只是和google-drive, 甚至word文檔的評(píng)注,區(qū)別不大固该。甚至我們可以在word或石墨筆記中锅减,使用這個(gè)模式,沒有引用語法伐坏,可以使用段落填充不同的底色...在word中把一段涂成彩色怔匣,這個(gè)簡(jiǎn)單的方法就是可以詭異地替代引用語法。
5.因?yàn)楹秃系膬x式感桦沉,所以我拒絕使用[edit-引用語法]每瞒,傾向于commit-comment 和合模式。