"Common Sense"または実用的な.NETコーディング標準

Question

私はコーディング標準のドキュメントを更新しようとしていますが、私はおそらく一般的に行われているより幾分高いレベルでそれらを書くことを考えています。私たちにはかなりの量の開発者が出入りしており、一般的には中間のスキルレベルです。私は低品質の "毛羽"セクションを排除したいと思います...例えば、 "変数命名規則"など...本当に疑わしい値で、文書の真価の部分から気をそらすもの過度の価値の低いコンテンツのためにスキミングされたりスキップされる可能性があります。

私は、人々が特定のやり方で行動するのではなく、愚かなことをしないようにすることにもっと興味があります。

私たちはOracle/Oracleのショップであることがありますが、私が探している資料のタイプについては、特に言語は重要ではないと思います。

これまで誰もこれをやっていて、共有してもらえないか、それとも似たような性質を持つ良いオンライン素材を見つけたのかな？

Answer 1

私は間違いなく標準的な文書よりもツールオプションReSharperを好んでいます。私が専門的に開発するほど、標準文書をコーディングすることは時間の無駄であり、生産性の低下につながることに気付きます。

コードは読みやすく理解できるものでなければなりません。残念ながら、コーディング標準ではどちらも強制できません。しかし、ツールは少なくとも命名規則を強制し、ヌルをチェックできなかったり、「変更されたクロージャへのアクセス」などの問題を見つけるのに役立ちます。

どのような場合でも、コーディング規格は、開発者に良いコードを書くことを決して許してはいけません。私は、三項演算子または演算子オーバーロードの使用を禁止する文書を見てきました。また、コードにコメントを付けることが必要な文書も見てきました（私は、すべてのコストをかけてコメントを避けようとしています）。私の意見では、これらの事柄のどれもコーディング標準にすべきではありません。

Answer 2

MSDNのguidelines for class developersには多くの優れた素材があります。あなたのような低レベルのものはたくさんありますが、それは実際にはより多くの価値がありますが、一見価値があります。

Answer 3

JPが投稿したガイドラインに従っているセクションや、そのコードが最低スコアでFxCopに合格する必要があります。これにより、ドメイン固有のガイドのために標準のスペースが広がります。

Answer 4

私の経験では、コーディング標準の実用的価値は、自動的に測定する能力に比例します。私たちのショップのC＃コーディング標準（1ページに収まる）の一部は、コードがFxCopとStyleCopの両方のデフォルトルールに従ってきれいでなければならないと言います。両方のツールは、開発者だけでなくビルドプロセスによっても実行できます。