1
rongpx95 2023-07-10 10:30:49 +08:00
有些麻烦,我在想,都详细点会有什么问题?
|
2
israinbow 2023-07-10 10:44:41 +08:00 via Android
公布用的隐藏细节用注解不就行了, 整两份给自己加工作量和心智负担何苦呢.
|
3
pkoukk 2023-07-10 10:47:08 +08:00
文档最常见的问题是经常跟不上代码的版本( hotfix 或者小更新,不总是会立刻更新文档),写两份文档更是会扩大这种问题
你说的那些细节,也没必要非要放到文档里,找起来改起来也不是特别方便,如果只是给自己看的话,我一般会写在更新日志/发布日志里 提醒一下自己找回记忆 |
4
zhenghuiy 2023-07-10 11:04:41 +08:00
空想的时候当然啥都行,但真正去做的时候,一定会受不了这个额外的工作量。
|
5
KDr2 2023-07-10 11:12:17 +08:00
这不是一式两份,这是两式。
|
6
flamiNNgo OP |
8
crazyTanuki 2023-07-10 11:26:29 +08:00 1
感觉你这是在整自己,不是整别人
|
9
DigitalG 2023-07-10 14:04:04 +08:00
如果是自己选择工具记录,可以用能加注释的文档方案,公布用导出的 markdown 或者 pdf
|
10
zexinwu84 2023-07-10 14:18:58 +08:00 via Android
一式两份不是这个意思
|
11
opengps 2023-07-10 14:37:58 +08:00
带有公司资料的,干脆别发布,一不小心都是在给自己挖坑
|
12
xiangyuecn 2023-07-10 14:57:30 +08:00
放心,自己写的代码,别说别人,过段时间自己都不愿意去看🐶
|