整理一下讨论中主张要写注解的理由，有些比较不必要
1. 程式的why “写个一行10~20个字这个method干麻”
这个可以写在test spec中。特别是BDD的testing lib的desribe还可以套很多层
应该够你写了
2. 责任分配 “// 此功能因某某某要求故加上”
这个应该是写在commit message，或是commit message上打issue系统的id
从issue可以看到开票的人和理由
3. 商业逻辑 “IFRS制度变换”
提出这个理由的人真的会在注解写那么多吗？
要实作什么需要应该是PM会写user story，在commit message给连结就好了
我不会说要不要写注解是对的还是错的
每个人环境不同，就必须有不同的行动来对应
不过我的环境会让我觉得要写注解是个例外或是最后手段
如果你很需要写上面三种注解
我会建议你考虑找新工作，你值得更好。