作者JasperChang (PeterChou)
看板Soft_Job
标题Re: [讨论] 如何补救文件不完整专案
时间Sun Jan 3 01:38:46 2021
※ 引述《joejoe14758 (嘘文也可以很温柔)》之铭言
: 原标题：如何维护商业逻辑
: ------------------------------------------
: 大家好
: 最近碰到的情况觉得很麻烦
: 像是常常PM不知道某段的商业逻辑是什麽
: 就来问我 常常我也不知道/忘记了 只能去翻翻code
: 因为频率蛮高的 有时候觉得自己是客服
: 我知道商业逻辑应该要写在规划书/规格上
: 但实际状况可能时间太赶或种种原因导致没有被记录到/不完整
: 想请问大家都是怎麽避免/改善这个情况的呢 谢谢
先说结论：不需要补救，管他去死
文件这种东西就是不计入绩效，
最多成为点缀 KPI 的东西
写一份好的技术文件就像概论教科书
读者看了舒服 爽
但写作者花了许多精力时间 回报趋近於零
有那个闲工夫不如多钻研技术 多开发功能
愈是高阶、薪水愈高的开发者
愈会跟你说技术文件开发文件很重要
但写作的永远不是他 他要花费时间提升自己
认真写文件的你不知不觉就因为浪费时间
在专业道路上远远落後
一种人例外 就是专门嘴炮指导架构的管理者
他们不是专业的软体架构师
领着丰厚的薪水 产出华丽的文件
却常常让实作者觉得有病
所以 聪明的开发者请多为自己的人生想想
如果你不是拥有大量技术股
请不要浪费生命写文件为人作嫁了
要烂 一起烂
--
※ 发信站: 批踢踢实业坊(ptt.cc), 来自: 36.225.184.172 (台湾)
※ 文章网址: https://webptt.com/cn.aspx?n=bbs/Soft_Job/M.1609609128.A.97F.html
1F：推 wintersxp: 中肯，感同身受，但我醒得太晚，人生已经废了01/03 08:13
2F：→ jej: 金融业还会有人靠腰你写错字 字体弄错 页数没有refresh01/03 09:28
3F：→ jej: 干 我就不相信稽核会来查核这些毛01/03 09:28
4F：推 Nitricacid: 中肯01/03 10:48
5F：推 aidansky0989: 命名做好注解写重点，没文件至少不会太惨01/03 11:00
6F：→ sharek: 如果你所谓的专业道路只局限於技术开发，自然不会重视01/03 11:01
7F：推 OriginStar: 国内认为的专业就是技术开发阿，对於软体工程的方法论01/03 11:10
8F：→ OriginStar: 当然就颗颗01/03 11:10
9F：推 now99: 不去补文件，只是挖洞给後人或一段时间後的自己而已01/03 11:43
10F：嘘 alihue: 歪理01/03 12:02
歪理？花钱啊！哪个公司不追人进度让人好好处理精美文件算绩效的，还是你就是那种拗人
※ 编辑: JasperChang (27.246.101.130 台湾), 01/03/2021 12:19:17
大公司小公司九成九要你自己 trace code 啦
※ 编辑: JasperChang (27.246.101.130 台湾), 01/03/2021 12:20:56
11F：推 csieflyman: 自己私下随手写笔记给自己查就好 就不必浪费时间管排01/03 12:26
12F：→ csieflyman: 版格式及完整性01/03 12:26
13F：推 hanshsu: 稽核好像真的会对喔 我同事上次schema写错字被开单了01/03 12:27
14F：推 joejoe14758: 我是原po 谢谢分享 这观点以前没有想过 会再想想的01/03 12:29
15F：→ joejoe14758: 谢谢01/03 12:29
16F：→ joejoe14758: 感觉上层不push这件事 那这件事情就不会有改善的机会01/03 12:30
17F：→ joejoe14758: 了01/03 12:30
18F：嘘 alihue: 刚好我公司不追人进度欸01/03 12:33
19F：→ alihue: 公司01/03 12:34
20F：→ alihue: 自己待的公司扭曲成这样别认为其他公司都这样搞，多出去01/03 12:35
21F：→ alihue: 别间公司看看吧01/03 12:35
22F：→ alihue: 我在台北待的公司01/03 12:36
23F：→ alihue: 也都没在看绩效和催进度谢谢01/03 12:36
24F：→ alihue: 同事们都在自动自发工作，谁在跟你凹人01/03 12:38
你才多去别家公司看看咧，懒的理你
※ 编辑: JasperChang (27.246.101.130 台湾), 01/03/2021 12:40:44
25F：→ samuel1988: 喔 废文 01/03 12:53
26F：→ samuel1988: 你不写文件怎麽整理架构和系统设计 01/03 12:53
27F：→ samuel1988: 一辈子码农典范 01/03 12:54
28F：→ samuel1988: 你没有文件怎麽沟通？你到底在哪家公司可以讲一讲 01/03 12:54
29F：推 layan: 中肯 01/03 13:02
30F：→ samuel1988: 你技术到顶能帮助团队往前吗 01/03 13:04
31F：推 yamakazi: 还好我们公司算绩效可以拿文件来抵，一堆人尤其主管不写 01/03 14:23
32F：→ yamakazi: 扣只写文件 01/03 14:23
33F：推 yamakazi: 如果跟日商公司合作过，你会发现日商特爱写文件 01/03 14:30
34F：→ yamakazi: 什麽8D, 5 why,好像都是toyota搞出来的那一套。有发现bu 01/03 14:32
35F：→ yamakazi: g後都会叫你写检讨报告 01/03 14:32
36F：→ yamakazi: 发哥也会叫人写PDCA 01/03 14:33
37F：嘘 as30385438: 同意自己待的公司扭曲别以为大家都这样，我公司写文 01/03 14:45
38F：→ as30385438: 件就是开ticket列入正式工作，这不做就是让专案慢性 01/03 14:45
39F：→ as30385438: 死亡而已 01/03 14:45
40F：→ t64141: 环境对写文件是否友善是一回事，归纳成文件无用/有害就很 01/03 14:48
41F：→ t64141: 奇怪了 01/03 14:48
42F：→ t64141: 写文件的过程是需要思考的，会有更多机会重新检视设计是 01/03 14:53
43F：→ t64141: 否恰当，後人看了也比较能知道当下这样设计的原因，有机 01/03 14:53
44F：→ t64141: 会避免不清楚历史背景而改错 01/03 14:53
45F：→ t64141: 且依你这论点，真遇到所谓九成九以外的公司可能也进不去 01/03 15:01
46F：→ t64141: ，而且你可能不会知道原因，接着继续归纳出九成九公司不 01/03 15:01
47F：→ t64141: 重视文件... 01/03 15:01
48F：嘘 CureYou: 好呛 01/03 19:27
49F：→ dream1124: 推t64141 而且写文件不计入工时的话应该向上反应才对吧 01/03 20:34
50F：→ dream1124: 哪有人上班有工作不算工时，叫你想办法生时间做的 01/03 20:35
51F：嘘 cokellen: .... 01/03 20:47
52F：→ jack0204: 所以你认为产粪code才是工作对不对 01/03 21:25
53F：→ airtsubasa: 原文很贴近职场啊，在台某假日商就是这种状况，又很爱 01/03 21:37
54F：→ airtsubasa: 轮调，无基础程式能力的人接专案改程式 01/03 21:37
55F：嘘 MoonCode: 01/03 22:00
56F：→ sayya2311: 不需有文件时就不用文件啊,你看满天的open source有完 01/03 22:51
57F：→ sayya2311: 整文件的了了无几, 有文件前先问为什麽需要文件吧.. 01/03 22:51
58F：→ alihue: 文件是对程式一个很好的 overview，先有概念再 trace 01/03 23:17
59F：→ alihue: code 会好上手很多。更别说有些是含有特地领域的知识，这 01/03 23:17
60F：→ alihue: 时若没文件，给你 debug mode 下断点你还是不知道为什麽 01/03 23:17
61F：→ alihue: 要这样 01/03 23:17
62F：推 kingofsdtw: 代表系统还不够大吧 01/03 23:52
63F：推 hellomotogg: 血尿推推 01/04 02:15
64F：嘘 sorryla: Google要升Senior有很大一部分的评比就是写文件 01/04 13:29
65F：→ airtsubasa: 可是你不在google阿！ 01/04 18:43
66F：→ viper9709: 不是这样吧~没写文件以後回来连自己都看不懂 01/05 00:16
67F：→ sorryla: 楼楼上，我之前在Google 01/05 02:40
68F：→ alihue: 楼上 XD 01/05 09:16
69F：推 airtsubasa: 那很好啊！不过发文者在鬼岛吧 01/05 13:00
70F：推 ms0443001: 鬼岛资讯日常 02/03 21:22
71F：嘘 Raymond0710: 歪风讨嘘 02/18 02:43