我即将开始更新我们的编码标准文档,我正在考虑也许可以在比通常所做的更高的级别上编写它们。我们有相当多的开发人员来来去去,他们一般都是中等水平的。我想消除低质量的“毛绒”sections...for示例,“变量命名约定”,etc...anything,它确实有可疑的价值,它分散了对文档中真正有价值的部分的注意力(由于过低的价值内容,这些部分可能会被略过或完全跳过)。
我更感兴趣的是确保人们不会做愚蠢的事情,而不是强迫他们以某种方式做事情。
我们碰巧是一家.Net /甲骨文商店,但对于我正在寻找的材料类型,我认为语言并不是特别重要。
我想知道是否有人以前做过这样的事情,并且有一些他们不介意分享的材料,或者遇到过类似性质的好的在线材料?
发布于 2009-05-08 20:19:56
与标准文档相比,我绝对更喜欢工具选项ReSharper。我越专业地开发,我就越意识到编写标准文档是浪费时间,而且往往会消耗生产力。
代码应该是可读和可理解的。不幸的是,编码标准也不能强制执行。然而,工具至少可以强制执行命名约定,并帮助发现问题,例如无法检查null或“访问修改的闭包”。
无论是哪种情况,编码标准都不应该阻止开发人员编写好的代码。我见过禁止使用三元运算符或运算符重载的文档。我也看到过需要对代码进行良好注释的文档(我会不惜一切代价避免注释,以支持可读的代码)。在我看来,所有这些东西都不应该出现在编码标准中。
https://stackoverflow.com/questions/841499
复制相似问题