COMMIT-COMMENT和合模式纪要
**小组:GS07E15gDAMA **
特别鸣谢:
ZoomQuiet 引领Github入门,并以丰富的经验,监督整个和合探索流程,引导并鼓励正确的探索思路,一票否决错误的思路,避免小组走上耗费时间且无效的弯路。
安心竹 以细腻的才思,和接地气的实干精神,四两拨千金,想出在新版本commit前,将不需要修改的行直接做空格处理的方式,节省一个专门用来空格,使可comment的新版本,赋予split对比视图在c-c模式中的有效意义。
一坪海岸线 最早提出空格说,为commit-comment模式的整体系统提供极其重要的启发思路,并且独立研发会议录音上传机制,以稳重的思路,凝聚并感染着全体小组成员。
申小七 以极其勤奋的态度,带动并加速了全小组的和合节奏,以放弃客户也要参加互怼会议的精神,成功把我们牢牢拽进语音会议室,以怎么怼都不生气,还会加倍努力怼回来的求知若渴,成功带着小组奔向和合大法。
以下,是和合技commit-comment模式的系统流程和小组规约
#commit-comment和合模式解决的核心需求
一览无余
对多人和合建议的一览无余
对所有历史成稿(非版本)的一览无余
#commit-comment和合模式综述:
阶段性冻结edit功能,所有成员使用commit界面,利用comment功能,对同一篇或多篇文章发表评论的和合模式。
#commit-comment 和合模式操作精要
在code中新建topic,发布初始文件,此为第一稿,发布者为第一作者。
commit 界面:打开commit 界面,第一稿发布后的初始状态,可以多人逐行comment. 请所有小组成员使用commit界面,针对第一稿逐行发表comment,此为第一轮comment
在第一轮comment进行中,全体小组成员,包括第一稿的第一作者,不得使用edit功能修改第一稿,不得更新版本。
小组决议结束第一轮comment 的时间节点。此处应该辅助以语音会议,第一作者需对comment进行反馈,或者第一作者在close comment 前回复所有comment,有来有往有交流才是真和合.
第一轮close comment 后,第一作者可以根据所有comment,使用edit功能修改第一稿,注意在此环节,修改过后不能直接点击commit。
接第五环节,正文修改完毕后,要将每一行前面,输入一个空格。空格全部输入完毕后,确认正文仍然左对齐,然欧点击commit,形成第二稿。
第二稿完成后,可开始进行第二轮comment。小组成员点击第二稿的github代码后,将进入第二稿的commit界面。
split视图:commit界面分为unitied 视图和split 视图。完成第二稿后,打开split视图,我们会清晰地看出,结合第一轮comment,第一作者做了哪些修改,即第一轮和合成果。
在第二轮comment中,我们统一采用split对比视图,针对右侧最新版本(也就是第二稿正文),逐行发表comment,即第二轮comment内容。
#commit-comment和合模式逻辑内因
在github“版本”概念基础之上,commit-comment和合模式提出整合多个“版本”的“成稿”的概念。即,通过时阶性禁用edit功能,用更佳清晰的comment功能来记录和合过程。避免github形成无效的新版本,将修改版本“隐藏”化,形成更层次分明的“成稿”迭代。类似photoshop中的合并图层,跨越历史记录的时序,强调经过和合之后,文章当下的整体效果。如果没有此成稿概念,很难再github中对版本进行分类分层.(貌似blame功能是做这个的,但是远没有分轮comment,定时edit形成的成稿迭代清晰)
github强调历史记录的时序,故每一次修改都形成一个新的版本,按照时间顺序排列。但是好中文的多人和合,不强调comment的时序,强调comment的有效信息量。好中文强调第一作者对多人建议的一览无余,不需要针对每条comment即时反馈。
github的设计目标对象是程序员,设计逻辑是,强调对变更的再修改。
split视图只能对比最新两个版本,无法对比历史版本。
#commit-comment 和合模式诞生的起点
打开一个文章的github代码链接,进入其commit界面。如果这不是这篇文章的初始形态,第一修改人已经对其进行edit,那么在commit界面,第二修改人只能针对第一修改人的变更进行评论。这不符合好中文和合“一览无余”的协作目标。
#commit-comment和合模式的替代品
1.针对诞生起点中提出的问题,其实还有第二条可行的解决路径,即[edit-引用语法]模型。
2.此模型的操作流程,即忽略commit界面(包括unitied和split),完全采用edit界面。
3.在edit界面,众人将修改意见以引用语法写入,并署名。使得意见可以同正文区分开。
4.以[edit-引用语法]模式,若完全放弃commit界面,所以多版本干扰等也都不是问题,只是和google-drive, 甚至word文档的评注,区别不大。甚至我们可以在word或石墨笔记中,使用这个模式,没有引用语法,可以使用段落填充不同的底色...在word中把一段涂成彩色,这个简单的方法就是可以诡异地替代引用语法。
5.因为和合的仪式感,所以我拒绝使用[edit-引用语法],倾向于commit-comment 和合模式。