对 lovetheory/nkc2 项目的观察

注意

本文仅一家之言,主观色彩强烈,不具有普遍性,也不具代表性。 本文的目的不是有意伤害任何团体或个人,只是罗列出个人对于某些事物的看法。

背景

  1. 很高兴看到本站的建站系统在github上托管(XXXXXXXXXXXXXXXXXX/lovetheory/nkc2
  2. 自诞生之日,就一直有专人维护,主要内容是是群众喜闻乐见的新功能添加和bug修复等
  3. 老虎批准 merge(估计就能上线)
  4. 快速迭代,快速部署

观察

  1. 提交的 commit 描述内容(comment)单薄,可跟踪性差。日后审计的时候难以搜索出针对某个特性描述的相应修改。 image.png

  2. 同理,部分 pull request 内容单薄,可跟踪性较差。(部分的pull request有写到更正内容) image.png

  3. 未实现完整的track system跟踪体系。 image.png

  4. 推荐使用至少两个分支,比如releasedevelopmaster)。方便管理各种快速迭代版本的发布并有助于实现简单可控的持续集成。

建议

理想的工作流程:

  1. 用户发现了一个bug,在issue board上开ticket。例: 标题:用户头像消失。 描述:用户尝试修改头像,上传png图片,图片不显示,取消操作后现有的头像图片一并消失。 系统自动分配ticket号码 #101
  2. 工程师修复后commitdevelop分支: Bug fix #101: 修复图片消失问题。原因:传入了错误的参数。
  3. 一般github在commit后会自动关闭原ticket(需要在commit里写上ticket#)
  4. 测试
  5. 在特定的时间段(如修复了多个小bug或严重影响使用的恶性bug),决定release,将develop并入release分支,并打上tag

新特性(feature)的跟踪同理。

后记

由于目前这个项目参与人员较少,对于文档需求、历史记录和开发进度追踪没有这么迫切。以上内容仅供参考。

[修改于 4 年前 - 2017-08-19 22:46:24]

来自:科创广场 / 科创茶话
1
celeron533 作者
4年2个月前
1楼
附上其他项目参考截图

image.png

image.png

回复
评论
加载评论中,请稍候...
200字以内,仅用于支线交流,主线讨论请采用回复功能。
折叠评论
zx-16533
4年2个月前 修改于 4年2个月前
2楼
支持一个。。
现在这个样子的原因估计是contributor就这么几个人。。
回复
评论
加载评论中,请稍候...
200字以内,仅用于支线交流,主线讨论请采用回复功能。
折叠评论
虎哥
4年2个月前
3楼
哈哈,首先打我的屁股。不过楼主说得很对,以后要改进。我还记得当年楼主牵头的open rocket汉化项目,组织得真好。
回复
评论
加载评论中,请稍候...
200字以内,仅用于支线交流,主线讨论请采用回复功能。
折叠评论
amo
4年2个月前
4楼
软件开发管理那么多流派,对立的也不少……几个人的小团伙,还是敏捷派比较合适,只要团伙不内哄散伙,慢慢就完善了。
那些为了文档而文档的,人力物力不足是玩不起的,也很耗费核心的精力……即使这样,如果中途找人来接手,也不是靠文档记录就能接下去的
回复
评论
加载评论中,请稍候...
200字以内,仅用于支线交流,主线讨论请采用回复功能。
折叠评论
zx-16533
4年2个月前
5楼
引用 amo:
软件开发管理那么多流派,对立的也不少……几个人的小团伙,还是敏捷派比较合适,只要团伙不内哄散伙,慢慢就完善了。
那些为了文档而文档的,人力物力不足是玩不起的,也很耗费核心的精力……即使这样,如果中途找人来接手,也不是靠文档记录就能接下去的
楼上大概没做过开源项目。。
回复
评论
加载评论中,请稍候...
200字以内,仅用于支线交流,主线讨论请采用回复功能。
折叠评论
celeron533作者
4年2个月前
6楼
引用 amo:
软件开发管理那么多流派,对立的也不少……几个人的小团伙,还是敏捷派比较合适,只要团伙不内哄散伙,慢慢就完善了。
那些为了文档而文档的,人力物力不足是玩不起的,也很耗费核心的精力……即使这样,如果中途找人来接手,也不是靠文档记录就能接下去的
也不是什么很详细的文档,只是最好把每次改动修复的东西和原因写上。毕竟是开源项目,没有统一的管理,需要有一种机制让任何中途加入的人知道某些修改的历史原因以及整个软件的故事。
回复
评论
加载评论中,请稍候...
200字以内,仅用于支线交流,主线讨论请采用回复功能。
折叠评论
celeron533作者
4年2个月前
7楼
另外补充一下 @虎哥

当有新的bug或feature的时候,统一计入issue board,打上不同的标签。在每个开发周期里,选出需要做的条目进行处理,剩下的就让他们躺在那里,等待下次机会。
这样管理的好处是:
1. 当然是有据可循了
2. 有时候一些功能要求挂出来后,其他成员可以提出帮助修改
3. 有可能一系列的bug出自同一个代码逻辑/模块,可以统一修复。甚至是重构
4. 当有些功能互相矛盾时,做出取舍并记录
回复
评论
加载评论中,请稍候...
200字以内,仅用于支线交流,主线讨论请采用回复功能。
折叠评论
bg8npk
4年2个月前
8楼
引用 celeron533:
另外补充一下 @ 虎哥

当有新的bug或feature的时候,统一计入issue board,打上不同的标签。在每个开发周期里,选出需要做的条目进行处理,剩下的就让他们躺在那里,等待下次机会。
这样管理的好处是:
1. 当然是有据可循了
2. 有时候一些功能要求挂出来后,其他成员可以提出帮助修改
3. 有可能一系列的bug出自同一个代码逻辑/模块,可以统一修复。甚至是重构
4. 当有些功能互相矛盾时,做出取舍并记录
学习了。
软件研发的管理目前已经有很多成功例子,跟着学习我有姿势我自豪.....
回复
评论
加载评论中,请稍候...
200字以内,仅用于支线交流,主线讨论请采用回复功能。
折叠评论
celeron533作者
1个月7天前
9楼

再加上CICD

回复
评论
加载评论中,请稍候...
200字以内,仅用于支线交流,主线讨论请采用回复功能。
折叠评论

想参与大家的讨论?现在就 登录 或者 注册

所属专业
上级专业
同级专业
celeron533
进士 学者 机友 笔友
文章
162
回复
2422
学术分
7
2011/06/06注册,1 个月前活动
暂无简介
%7B%22isDisplay%22%3Atrue%7D

仅供内部学术交流或培训使用,请先保存到本地。本内容不代表科创观点,未经原作者同意,请勿转载。

下载

插入资源
全部
图片
视频
音频
附件
全部
未使用
已使用
正在上传
空空如也~
上传中..{{f.progress}}%
处理中..
上传失败,点击重试
等待中...
{{f.name}}
空空如也~
(视频){{r.oname}}
{{selectedResourcesId.indexOf(r.rid) + 1}}
处理中..
处理失败
插入表情
我的表情
共享表情
Emoji
上传
注意事项
最大尺寸100px,超过会被压缩。为保证效果,建议上传前自行处理。
建议上传自己DIY的表情,严禁上传侵权内容。
点击重试等待上传{{s.progress}}%处理中...已上传
空空如也~
草稿箱
加载中...
此处只插入正文,如果要使用草稿中的其余内容,请点击继续创作。
{{fromNow(d.toc)}}
{{getDraftInfo(d)}}
标题:{{d.t}}
内容:{{d.c}}
继续创作
删除插入插入
{{forum.displayName}}
{{forum.countThreads}}
篇文章,
{{forum.countPosts}}
条回复
{{forum.description || "暂无简介"}}
ID: {{user.uid}}
学术分隐藏
投诉或举报
加载中...
{{tip}}
请选择违规类型:
{{reason.type}}

空空如也

支持的图片格式:jpg, jpeg, png
插入公式
分享回复:{{shareId}}
加载中...
评论控制
加载中...
文号:{{pid}}
投诉或举报
加载中...
{{tip}}
请选择违规类型:
{{reason.type}}

空空如也

加载中...
详情
详情
推送到专栏从专栏移除
设为匿名取消匿名
查看作者
回复
只看作者
加入收藏取消收藏
加入关注取消关注
折叠回复
置顶取消置顶
评学术分
鼓励
设为精选取消精选
建议修改
编辑
通过审核
评论控制
退修或删除
历史版本
违规记录
投诉或举报
加入黑名单移除黑名单
查看IP
{{format('YYYY/MM/DD HH:mm:ss', toc)}}
投诉或举报
加载中...
{{tip}}
请选择违规类型:
{{reason.type}}

空空如也

下载资料
{{fileName}}
大小:{{size}}
下载当前附件将花费 {{costMessage}}
{{description}}
你当前剩余 {{holdMessage}}
{{fileName}}
大小:{{size}}
当前附件免费。
你已购买过此附件,下载当前附件不需要花费积分。
加载中...
{{errorInfo}}
附件已丢失
当前账号的附件下载数量限制如下:
时段 个数
{{f.startingTime}}点 - {{f.endTime}}点 {{f.fileCount}}