Welchen Delphi-Codierungsstandards folgen Sie?

Question

Welchen Delphi-Codierungsstandards folgen Sie?

Unsere Firma versucht, einige bessere Codierungsstandards einzuführen, um die Lesbarkeit, Überprüfbarkeit und Wartbarkeit unseres Codes zu verbessern. Wir sind CodeGears "Object Pascal Style Guide" begegnet, aber es wurde schon eine ganze Weile nicht mehr berührt und ich kann mir vorstellen, dass einige Leute lokale Verbesserungen oder Ergänzungen vorgenommen haben. Ich bin auf einige veröffentlichte Varianten und andere Dokumente gestoßen, die ich unten aufführen werde.

NB: Ich mache nicht will einen Stil Krieg zu starten. Ich möchte nur wissen, welchen Standards Sie folgen und warum.

Danke.

---

UPDATE: Nun, die "JCL Delphi Sprache Style Guide" scheint der klare Sieger zu sein! Vielen Dank!

Answer 1

JCL Delphi Sprache Style Guide

(Eine Verlängerung der CodeGear „Object Pascal Style Guide“)

http://jcl.delphi-jedi.org/documents/styleguide.html

(Danke, Jeroen Pluimers, für zu bemerken, dass der ursprüngliche borland.com Link gestorben war und für die neue Verbindung bereitgestellt wird.)

Answer 2

CodeGear „Object Pascal Style Guide“

http://edn.embarcadero.com/article/10280

Answer 3

JVCL-erweiterte Version von CodeGear „Object Pascal Style Guide“

(Dies sieht aus wie die JCL-Version, zu mir.)

http://jvcl.delphi-jedi.org/StyleGuide.htm

(Dank Jeroen Pluimers gehen, für die neue Verbindung bereitgestellt wird.)

Answer 4

econos - (. Untertitel „Delphi 4 Leitfaden Coding Standards Document Developer“) Coding Standard Dokument

http://www.econos.de/delphi/cs.html

Answer 5

CodeGear „Ungarische Erdnussbutter“, für die Benennung von Identifikatoren

http://dn.codegear.com/article/27983

Answer 6

About.com des „Delphi Identifier Namenskonventionen“

http://delphi.about.com/od/standards/l/bldnc.htm

Answer 7

Es spielt wirklich keine Rolle, solange Sie eine auswählen und dabei bleiben.Ein Kodierungsstandard ist wie ein Dialekt, und solange alle im Team den gleichen Dialekt sprechen, geht es Ihnen gut.

Das heißt, warum nicht den gleichen Standard wie Ihre Laufzeitbibliothek (VCL) und Dokumentation verwenden? Dann werden Sie alle den gleichen Dialekt sprechen und es wird Ihnen leichter fallen, den Code der Laufzeitbibliothek zu lesen. Und es gibt viele Codebeispiele, um Codierungskonventionen zu veranschaulichen.

Answer 8

Es kann eine Tendenz geben, Codierungsstandards so weit zu übersteuern, dass sie dem Schreiben von Code in die Quere kommen.

Ich stimme mit Jozz Kommentar. Sie können sich alle empfohlenen Standards ansehen, einen auswählen und Ihren Codierern aufzwingen oder Sie können Ihr Team in den Prozess einbeziehen.

Nach meiner Erfahrung ist der beste Weg, um ein Team zu engagieren, das Team mit der Idee und den Vorteilen der Adoption zu kommen. Ihr vorhandenes Talent ist Ihre beste Ressource. Ebenso können sie dein ultimativer Feind sein, wenn du sie auf einen Pfad zwingst, den sie nicht kaufen.

Also, nehmen Sie einen Blick auf Ihre bestehenden Kodierungsvarianten und das Team zusammen für einige lebhafte Diskussionen erhalten auf:

• Die Gründe für einen Codierungsstandard übernehmen.
• Wesentliche Überlegungen in der Standardisierung.
• Auftauchen von Unsicherheiten in dem Team rund um dieses Problem.
• Einen Punkt der Übereinstimmung finden. Was ist wichtig und was nicht?
• Etablieren einiger Unternehmensziele, so dass jeder das Gefühl hat, auf ein gemeinsames Ziel hinzuarbeiten.
• Lassen Sie das Team die Vorteile der Standardisierung für sich selbst verkaufen.

Das wichtigste Ziel muss sein, einen "Standard" zu etablieren, der Ihrem Team und Ihrem Unternehmen am besten dient.

Answer 9

Aus irgendeinem historischen Grund ist der Codierungsstandard bei meiner Arbeit, alle Schlüsselwörter in Großbuchstaben zu haben, sowohl in Delphi als auch in SQL. Danke Gott für die Feststelltaste.