どのようにあなたのプログラムの語彙を維持するのですか?
プログラムでは、それほど小さいときには、コードの可読性、一般的な用語、あるためそれほど-いくつかのエンティティを、の維持以外のメンバーの間にチームの理解を向上させる相互、1つの語彙をする必要がある定義し、維持するプログラム。 どうすれば(またはお客様の会社)このタスクに対処する、どのような規律は、持っているかの手配は、ご紹介ですか? |
5 Replies
1)
合理的なサイズのほとんどのプロジェクトは一般的な規則とに従う必要があります名前付けのガイドラインを規定/コーディング標準文書のプログラミングが必要です。 もう1つの方法は、コードレビューを介してを支援する。明らかにレビューのうちいくつかの調整が(文書は、を助ける必要もあります)。コードレビューは同様にトラックや行為の通りコーディング標準を適用するように環境に優しい開発者および上級開発者を保つのを助ける。 |
2)
あなたのパッケージを論理的なグループに/モジュールとわかりやすい簡潔な名前を使用して分割します。を除いて避けて一般的な名前は本当に機能や機能のグループのカウンタなどを作成する規則をしている場合、それらに固執する。 |
3)
それは、プログラマは、ドメインの語彙を受け入れることを奨励からドメイン駆動デザインは面白い、ここです。上で、そこにも、サービスのような用語を知られているアプリケーションの部品を使用して参照できるようにいくつかの設計規則は、の上部に、リポジトリ、工場など ドメインの語彙を組み合わせることで、上記のそれは良い解決策になる可能性が技術的な規則を使用します。 |
4)
私のチームは)wikiにこの種の情報(/語彙等規則を保持します。これは、簡単に日付と共有を維持することができます。 |
5)
@イリヤRyzhenkov、 私はほとんどの企業はこのような実践を持っていない怖い:)私は、いわゆる中小企業の百万のLOCのコードベースで働いてきた彼らがですべてのドキュメントを持っていないすべての(横にコーディングガイドライン共通) 私たちが一般的な用語我々のアプリケーションドメインで使用されるシソーラスを維持し、コードレビューの際に使用される私のプロジェクトについて。私は分析した。NETのXMLドキュメントのdiffを随時、どのエンティティがシソーラスに追加する必要条件を\決定する。のみシソーラスのガイドラインコーディングされたの遵守を強制するということです。 Wikiのアプローチは、誰も定期的に更新する気が非適用であることが証明:) 私は方法がジェットブレーンズで使うのですか思ったんだけど?私は、反射でReSharperのコードを検査したエンティティの名前番号と驚きました:) |