Delphi Style Guide v2.1.0

Delphi Style Guide v2.1.0

Release Date: 2025-10-09

🎯 What's New

Major Feature: Unit Naming Conventions and Namespace Hierarchy

This release introduces comprehensive guidelines for modern Delphi project organization using namespace hierarchies.

Key Additions:

1. New Section 3.1: "Unit Naming Conventions and Namespace Hierarchy"

   • Comprehensive guidelines for hierarchical unit organization
   • Standardized suffixes for Forms (.Form.pas) and Data Modules (.DM.pas)
   • Support for nested hierarchies (e.g., Customer.Details.Form.pas)
   • Clear naming patterns: Unit → File → Class → Instance

2. Quick Start Enhancement

   • New "Unit Names (Namespace Hierarchy)" section
   • Quick reference examples for immediate use

3. Release Automation

   • Automated release creation with create-release.sh
   • YAML-based configuration (release-config.yaml)
   • PDF generation from Markdown

📦 Release Contents

This release includes:

• Delphi Style Guide DE.pdf (110 KB - German)
• Delphi Style Guide EN.pdf (95 KB - English)
• .gitignore (2.8 KB - Ready-to-use Git ignore file)
• .gitattributes (1.5 KB - Ready-to-use Git attributes file)
• LICENSE.md, README.md, README.de.md

📋 Examples

Simple Structure

unit Main.Form;              // File: Main.Form.pas
                            // Class: TFormMain
                            // Instance: FormMain

unit Main.DM;               // File: Main.DM.pas
                            // Class: TDMMain
                            // Instance: DMMain

Nested Hierarchy

unit Customer.Details.Form;  // File: Customer.Details.Form.pas
                            // Class: TFormCustomerDetails
                            // Instance: FormCustomerDetails

unit Customer.Details.DM;    // File: Customer.Details.DM.pas
                            // Class: TDMCustomerDetails
                            // Instance: DMCustomerDetails

🌍 Language Support

Both versions updated synchronously:

• ✅ German (Delphi Style Guide DE.md)
• ✅ English (Delphi Style Guide EN.md)

📊 Version Comparison

Aspect	v2.0.0	v2.1.0
Format	PDF only	PDF + Git Files
Size	402 KB	207 KB
Unit Naming	Basic	Comprehensive
Namespace Hierarchy	❌	✅
Quick Start	✅	✅ Enhanced
Git Files	❌	✅ (.gitignore + .gitattributes)

---

Author: Olaf Monien
License: MIT

Delphi Standards v2.0.0

Delphi Standards 2.0

Includes:

• Delphi Style Guide (EN/DE) – also provided as PDFs
• .gitignore template
• .gitattributes template

Usage note: Add the two git templates (.gitignore and .gitattributes) to the root of your repository/workspace.