テーマ: code-quality
-
コードの意図が伝わる識別子の命名
ドメインの語彙を使い、対象が何であるか、何をするかを示す名前を選ぶ。長さは使われる範囲に合わせる。型などの符号化、略語、型について誤解を招く名前を避け、理解が深まったら名前を変える。
-
Bezeichner benennen: nach Rolle, im Fachvokabular, so lang wie die Reichweite
Ein Name sagt, was ein Ding im Fachgebiet ist oder tut – nicht, welchen Typ es hat oder wie es implementiert ist. Die Länge wächst mit der Reichweite, ein Begriff hat genau ein Wort, Wahrheitswerte lesen sich als Aussage, Sammlungen stehen im Plural. Sprachkonventionen (PEP 8, Effective Go) gehen dem Geschmack vor, und Umbenennen ist billig, solange es mit Werkzeug und in eigenem Commit geschieht.
機械可読: JSON