技术文档一式两份是不是比较好
这是一个创建于 889 天前的主题，其中的信息可能已经有所发展或是发生改变。
一份自己看，规整、详细、啥都有
一份公布用，主要是应付文档要求、同时隐藏一部分细节
自己写可以不用那么规范，同时自己写的，看到细节能知道是什么
提升替换成本？
一份公布用，主要是应付文档要求、同时隐藏一部分细节
自己写可以不用那么规范，同时自己写的，看到细节能知道是什么
提升替换成本？
 | 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 放心，自己写的代码，别说别人，过段时间自己都不愿意去看 |
Select Language