倡议: 基于 Issue 写作协同

[ZoomQuiet]

背景

~ 阐述 记录/问题/事件/... 发生的背景

进入 github 的很多小组开始根据网络中的随机教程来组织小组写作协同

• 导致权限不明的情况中意外进入 Pull-Request 模式
• 仓库起床名混乱:
  • homework-1.md
• 滥用仓库:
  • S01E01-GC4WP-YZG
  • S02E05-GC4WP-YZG

分析

~ 先给出自己的态度以及尝试

因为:

• 还未敢尝试所有github 功能
• 对网络协作并没有具体经验
• 以至无法有效结合现有小组状态和功能树, 定制自己小组最简单的协同流程

目标

~ 小组作业的目标是什么?

• 和合技体验 看起来是最重要的目标?
• 其实,相反:
  • 通过合适的包含协作精神的环境
  • 加速大家开始习惯协作
  • 以致在落笔时多想想成员阅读/诵读/修改/发布/... 时的感受
  • 这就是写作的训练

姿势

~ 所以, github 中如何极简的进入协同写作, 而不是 git 什么的工具学习?

全 web 标准操作

• 不用 git 工具
• 组长批量构建好仓库+作业目录+作业文件
• 优点:
  • 成员就在指定的文件中直接进行反复修订即可
• 问题:
  • 组长的能力/权限配置...都需要大量的支持/培训

全 issue 协同

~ issue 是支持 markdown 的全功能小组BBS --> demo[L02]翻译奶

• 配置:
  • 每期作业有对应 mailstone
  • 每个小组有对应 projects
  • 每个作业阶段都有 labels 对应:
    • 0:discuss 析题
    • 1:draft 起稿
    • 2:TUV 和合
    • 3:publish 发布
    • 4:enhancement 修订
    • 5:logging 回顾
• 行为:
  • 组长发起作业给出要求/草稿
  • 成员回复自己的版本/部分
  • 对应表情/回复讨论
  • 综合/决策/和合后, 在正文完成修订
• 模式:
  • 主笔轮值模式, 每位主笔负责场外合并成员文稿发布版本稿件为新回复, 大家通过表情来投票, 回复给出意见或是场外实时讨论测定修订什么
  • 多人多版本并行模式, 每个人回复发布自己的版本, 多次迭代后场外协商选择编辑为小组作业
  • 多人分段协同....
  • ....

全 project 协同

~ project 的卡片形式是 和合7柱帐本的最简模仿形式 --> Mg3La2

• 小组专有 project 空间
• 每个成员一个泳道
• 作业每段分拆为对应卡片
• 每个成员在对应自己泳道中的卡片进行修订
• 最终合成->发布
• ...

综合协同

• E01 型作业在 Isuue 中推进
• E05 型作业在 Issue 中追踪进展, Project 中和合
• E51 型作业...

变更

~ 记录合并学员建议/增补的主要变动信息

• 17204 ZQ init.
• ... 使用日期 作者 记要 <-- 这种行格式来嗯哼

 .
  .
...

参考: 禁止事项清单

@GC4WP/4all

[mengfu1973]

初步学习了，还需要在实操中摸索。