我自己做一个小项目,过去都没有写开发日志的习惯,现在逻辑代码越来越复杂,必须要有注释了,但是因为代码不加密不压缩不去注释,不准备在代码上写注释,准备写开发日志,把功能注释记录在日志上,而日志文件则一个月用一个 md 文件,保存在 OneDrive。
想问大家写开发日志吗?你们是怎样写开发日志的?
我自己做一个小项目,过去都没有写开发日志的习惯,现在逻辑代码越来越复杂,必须要有注释了,但是因为代码不加密不压缩不去注释,不准备在代码上写注释,准备写开发日志,把功能注释记录在日志上,而日志文件则一个月用一个 md 文件,保存在 OneDrive。
想问大家写开发日志吗?你们是怎样写开发日志的?
|
kslrJun 17, 2018
1
代码写注释
写笔记 git 记录 |
|
yanaraikaJun 17, 2018
3
代码注释、wiki 记录与 git 提交 /PR 是三个不同层次的东西。注释是实现层面的东西,直接写在代码里;整体架构介绍、部署方法、结构等写在 wiki 里;一项新功能 /开发目标的达成写在 pull request 里。上面这几项在 Github/Gitlab 之类的都能一站式完成,不要分散在别的地方
|
|
msg7086Jun 17, 2018
4
最近写的项目。
注释是这么写的,所以开发日志就不写了,我个人觉得写了没意义。 https://github.com/msg7086/rb1drv/blob/master/lib/rb1drv/onedrive_dir.rb 不写注释是可以的,即代码就是注释。只不过我还没到那境界,不写注释的话很多写得乱的代码自己都会跟不上。 |
|
crayygyJun 17, 2018 via iPhone
9
我个人比较喜欢写 wiki 和博客,在做完一个新功能以后把前后的需求和实现都记录下来(公司项目),这样每次 manager 找我要相关的资料的时候直接丢一个链接就好了
|
|
10
文档写的再好,代码乱得 1b 有什么用,改起来还是痛苦。不如想着把代码结构改明白了,之后看了就能尽快上手。
|
|
VDimosJun 17, 2018 via Android
12
还是要有自己的代码风格,一看就知道这里的意思那种。
|
|
13
@smdbh 我的代码挺简洁,一眼就能看出来这是干什么用的。但是代码只能干自己的活,并不能告诉下我当时为什么这么写啊。
我这个项目运行快四年了,我现在充分意识到好记性不如烂笔头,日志相当重要。没有日志,第 N 次修改之后,看着已经面目全非的代码,你只知道这个代码是干嘛用的,很难想起这些年来踩过的坑都有哪些,有可能一不小心又踩一次。 |
|
14
@VDimos 看懂代码没问题,代码很简洁,我一直没注释就是因为不用注释代码也能看懂。然而,我最近做了比较大的修改才意识到以前没把踩过的坑记录下来是错误的,有的坑又重新踩了一次。
|
|
renothingJun 17, 2018
15
赞同 2 楼的,直接写在 git 日志里最好,写单独文档笔记大部分时候纯粹是因为当时偷懒不好好写 git log 的缘故。
|
|
zjsxwcJun 17, 2018 via iPhone
16
我们是在 redmine 里的开发需求下,把业务逻辑也一起记录,然后开发时无脑干类似“填空”的体力活好了,然后写完代码在最后的合并提交的注释里也备注上这个 redmine issue 的 id,就可以追踪代码了,方便以后接手的人继续维护
|
|
17
大的设计写在 readme 里,小的设计写在关键函数上面,复杂的逻辑随手写注释,公用的包还可以专门写个 doc 文件。
剩下的除了写专门做分享用的文档,没找到需要写开发日志的场景 |
|
rb6221Jun 17, 2018 via Android
18
记性不好,有写注释的习惯,不过也仅是在有坑的地方特别写一下。
有人说「代码即是注释」,大部分情况下是可以的,不过如果有坑,那就需要写了。比如某个地方和其他的处理不一样,这种地方多了脑子是记不完的,为提醒自己也提醒后来的维护者,还是推荐写注释 |
|
anotherlfJun 17, 2018 via Android
19
不写注释可不是好习惯啊。
|
|
20
function lb() {
vim ~/logbook/$(date '+%Y-%m-%d').md } |
|
21
东西记在 jira 里,git branch 按照格式填入 jira 号,devops+脚本会管理的
|
|
hjdtlJun 17, 2018
22
先想功能,写下实现步骤加上图文注释。再写代码实现该功能。
一种记录形式,相当于开发日志了。 |
|
SingeeKingJun 18, 2018
23
日志。。比如这个? |