COMMIT-COMMENT和合模式紀(jì)要
**小組:GS07E15gDAMA **
特別鳴謝:
ZoomQuiet 引領(lǐng)Github入門,并以豐富的經(jīng)驗,監(jiān)督整個和合探索流程,引導(dǎo)并鼓勵正確的探索思路,一票否決錯誤的思路,避免小組走上耗費時間且無效的彎路。
安心竹 以細(xì)膩的才思,和接地氣的實干精神,四兩撥千金,想出在新版本commit前,將不需要修改的行直接做空格處理的方式,節(jié)省一個專門用來空格,使可comment的新版本,賦予split對比視圖在c-c模式中的有效意義。
一坪海岸線 最早提出空格說,為commit-comment模式的整體系統(tǒng)提供極其重要的啟發(fā)思路,并且獨立研發(fā)會議錄音上傳機制,以穩(wěn)重的思路,凝聚并感染著全體小組成員。
申小七 以極其勤奮的態(tài)度,帶動并加速了全小組的和合節(jié)奏,以放棄客戶也要參加互懟會議的精神,成功把我們牢牢拽進(jìn)語音會議室,以怎么懟都不生氣,還會加倍努力懟回來的求知若渴,成功帶著小組奔向和合大法。
以下,是和合技commit-comment模式的系統(tǒng)流程和小組規(guī)約
#commit-comment和合模式解決的核心需求
一覽無余
對多人和合建議的一覽無余
對所有歷史成稿(非版本)的一覽無余
#commit-comment和合模式綜述:
階段性凍結(jié)edit功能,所有成員使用commit界面,利用comment功能,對同一篇或多篇文章發(fā)表評論的和合模式。
#commit-comment 和合模式操作精要
在code中新建topic,發(fā)布初始文件,此為第一稿,發(fā)布者為第一作者。
commit 界面:打開commit 界面,第一稿發(fā)布后的初始狀態(tài),可以多人逐行comment. 請所有小組成員使用commit界面,針對第一稿逐行發(fā)表comment,此為第一輪comment
在第一輪comment進(jìn)行中,全體小組成員,包括第一稿的第一作者,不得使用edit功能修改第一稿,不得更新版本。
小組決議結(jié)束第一輪comment 的時間節(jié)點。此處應(yīng)該輔助以語音會議,第一作者需對comment進(jìn)行反饋,或者第一作者在close comment 前回復(fù)所有comment,有來有往有交流才是真和合.
第一輪close comment 后,第一作者可以根據(jù)所有comment,使用edit功能修改第一稿,注意在此環(huán)節(jié),修改過后不能直接點擊commit。
接第五環(huán)節(jié),正文修改完畢后,要將每一行前面,輸入一個空格。空格全部輸入完畢后,確認(rèn)正文仍然左對齊,然歐點擊commit,形成第二稿。
第二稿完成后,可開始進(jìn)行第二輪comment。小組成員點擊第二稿的github代碼后,將進(jìn)入第二稿的commit界面。
split視圖:commit界面分為unitied 視圖和split 視圖。完成第二稿后,打開split視圖,我們會清晰地看出,結(jié)合第一輪comment,第一作者做了哪些修改,即第一輪和合成果。
在第二輪comment中,我們統(tǒng)一采用split對比視圖,針對右側(cè)最新版本(也就是第二稿正文),逐行發(fā)表comment,即第二輪comment內(nèi)容。
#commit-comment和合模式邏輯內(nèi)因
在github“版本”概念基礎(chǔ)之上,commit-comment和合模式提出整合多個“版本”的“成稿”的概念。即,通過時階性禁用edit功能,用更佳清晰的comment功能來記錄和合過程。避免github形成無效的新版本,將修改版本“隱藏”化,形成更層次分明的“成稿”迭代。類似photoshop中的合并圖層,跨越歷史記錄的時序,強調(diào)經(jīng)過和合之后,文章當(dāng)下的整體效果。如果沒有此成稿概念,很難再github中對版本進(jìn)行分類分層.(貌似blame功能是做這個的,但是遠(yuǎn)沒有分輪comment,定時edit形成的成稿迭代清晰)
github強調(diào)歷史記錄的時序,故每一次修改都形成一個新的版本,按照時間順序排列。但是好中文的多人和合,不強調(diào)comment的時序,強調(diào)comment的有效信息量。好中文強調(diào)第一作者對多人建議的一覽無余,不需要針對每條comment即時反饋。
github的設(shè)計目標(biāo)對象是程序員,設(shè)計邏輯是,強調(diào)對變更的再修改。
split視圖只能對比最新兩個版本,無法對比歷史版本。
#commit-comment 和合模式誕生的起點
打開一個文章的github代碼鏈接,進(jìn)入其commit界面。如果這不是這篇文章的初始形態(tài),第一修改人已經(jīng)對其進(jìn)行edit,那么在commit界面,第二修改人只能針對第一修改人的變更進(jìn)行評論。這不符合好中文和合“一覽無余”的協(xié)作目標(biāo)。
#commit-comment和合模式的替代品
1.針對誕生起點中提出的問題,其實還有第二條可行的解決路徑,即[edit-引用語法]模型。
2.此模型的操作流程,即忽略commit界面(包括unitied和split),完全采用edit界面。
3.在edit界面,眾人將修改意見以引用語法寫入,并署名。使得意見可以同正文區(qū)分開。
4.以[edit-引用語法]模式,若完全放棄commit界面,所以多版本干擾等也都不是問題,只是和google-drive, 甚至word文檔的評注,區(qū)別不大。甚至我們可以在word或石墨筆記中,使用這個模式,沒有引用語法,可以使用段落填充不同的底色...在word中把一段涂成彩色,這個簡單的方法就是可以詭異地替代引用語法。
5.因為和合的儀式感,所以我拒絕使用[edit-引用語法],傾向于commit-comment 和合模式。