Thema: naming
-
Dokumente und Dateien so benennen, dass sie sich sortieren, finden und dauerhaft bestehen lassen
Eine Namenskonvention für Dateien legt die Bestandteile eines Namens und ihre Reihenfolge fest, ein Trennzeichen, den portablen Zeichensatz, ein Datum im ISO-Stil, das sich als Text sortieren lässt, mit Nullen aufgefüllte Sequenznummern und explizite Versionen; sie wird einmal pro Ordner niedergeschrieben und verlässt sich nie auf Gross-/Kleinschreibung oder Leerzeichen.
-
Ein Projektglossar als gemeinsames Vokabular pflegen
Ein Glossar gibt jedem Fachbegriff einen bevorzugten Namen, eine Definition, seine Beinahe-Synonyme mitsamt deren Unterschieden und einen Status; Dokumente schreiben Abkürzungen bei der ersten Verwendung aus und verlinken auf den Eintrag, und das Umbenennen eines Konzepts aktualisiert das Glossar in derselben Änderung wie Code und Dokumentation.
Maschinenlesbar: JSON