还好八
反正注释这种东西，也太详细也没人看
最多就函式功能、输入输出写写
然后复杂的算法写写
我觉得程式写的清楚比较重要
原厂给我的code，每个模组都用一堆全域变量
单独跑可能还好，要让两个模组一起跑就各种奇怪的问题
测试也不全面
开发到一半，发现硬件动不起来
拿示波器测波形也没出来
最后边看code 边看手册 才发现他时钟树设错 要自己除PLL频率改参数
本来以为这已经很夸张了
但我同事会写这样的code
有个需求是调整倍率 然后调整之后 要在画面上显示一段时间消失
1、1.5、2、2.5、3这样
通常来说可能就是
label、设定倍率(倍率)、timer(秒) 这样的组合
先用设定倍率(倍率)设定label的值，然后设个timer多久隐藏
然后他这样写
label[0]
label[1]
label[2]
label[3]
label[4]
timer0
timer1
timer2
timer3
timer4
每个label都是固定文字，选到哪个就用对应的定时器显示N秒后消失
https://i.imgur.com/CLs8LGE.png
相比之下 我觉得注释根本就可有可无

这才是实务经验 注解根本不可信 浪费时间

你都说完了还有什么问题

反正最后编译起来都会变成没有意义的文字(?)

实务经验个屁啊，过犹不及。

还好吧，这样写到时候改成别的讯息很方便啊

当注解写Dont remove 或Dont modify配上一个十年前的日期以及一个不在的人命，敢改就看你八字够不够重

这个写法就是实务上可行，但我前公司的code review只要看的人用0.5就可以让对方飞到天花板上当然你们如果没有这样的code review那我也没差能让人飞到天花板的理由很简单，你现在知道要求是1/1.5/2/2.5/3倍，那你身为一个合格的员工应该要想像到以后会有0.25/1.75等需求，在没有特别要求的情况下就应该自动刻出一个generalize的功能老实说这理由很见正大光明，我看到谁被电的话也只会笑他活该，但你们公司如果不想这样电人也不是不行

你是不是没看过主管没一个会软件的公司

你同事的写法才是比较实在的，你讲的hard code写法才糟

能动就好