Ich schreibe gerade unsere Kodierungsstandards für die Delphi-Programmierung nieder, was sollte jemand als Grundlage vorschlagen, alles, was Sie empfehlen würden zu verwenden/nicht zu verwenden?Delphi Kodierungsstandards
Ich habe Delphi Language Coding Standards Document als Basis für ein internes Dokument verwendet.
Die Object Pascal Style Guide könnte wahrscheinlich die "offizielle" bezeichnet werden, denke ich - soweit es so etwas gibt.
Seien Sie vorsichtig, wenn Sie sich nicht zu sehr mit Normen befassen. Vielleicht möchten Sie ein paar Beispielbeispiele von Ihren erfahrensten Programmierern sammeln, sie dazu bringen, zuzustimmen und diese als Vorlagen für alle zu verwenden.
Jeff Atwood hatte vor kurzem einen interessanten Blog-Eintrag über nur einen Aspekt von Standards: "Death to the Space Infidels!" und dort sagt er: "Es ist eigentlich egal, welche Kodierungsstile Sie wählen. Was zählt ist, dass Sie und alle anderen in Ihrem Team, hält sich an diese Konventionen und nutzt sie konsequent. "
Ich wünschte, ich könnte das mehr als einmal verbessern ... –
Nun, ich stimme zu, aber ich denke nicht, dass dies die Frage beantwortet. –
Ich hasse "Konvention Kriege", wo eine halbe Codebasis eine Konvention verwendet, und die Hälfte verwendet ein komplettes Gegenteil, vor allem wenn eine dieser Hälften den VCL-Quellen widerspricht, die der Ursprung dessen sind, was jetzt für alle Delphi-Quellcode Idiomatisch ist. –
Coding-Standards sind ein klassisches Bike-Shed-Thema. Die Leute streiten und streiten sich um dieses Zeug, WEIL es klein und letztlich nicht so wichtig ist, wie gutes Design. Sauberer, lesbarer Code ist es wert, und sauber lesbarer schlecht entworfener Code ist sehr wenig besser als unleserlicher schlecht entworfener Code. Vielleicht macht der schlecht lesbare Code es leichter herauszufinden, dass er weggeworfen werden muss.
Bemühungen, Teammitglieder dazu zu ermutigen, sauber lesbaren Code beizutragen, können die Förderung von Styleguides beinhalten. Styleguide-Reviews, bei denen Sie wiederholt jemanden für den falschen Stil verprügeln, sind kontraproduktiv. Wenn jemand Schwierigkeiten hat, einen akzeptablen Stil zu verwenden, sollten Sie ihn mit einigen Tools vertraut machen. Lassen Sie nicht einen sehr fähigen Programmierer unter der Belastung von zu viel Kritik über sehr kleine Punkte knicken.
Ich habe mir diese beiden Dokumente angesehen und sie sind beide schrecklich formatiert und veraltet mit Delphi 2009. Was ich nicht tun will, ist "Stil" zu erzwingen, nur eine Reihe von Regeln, um innerhalb zu arbeiten. – Mmarquee