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

Author: Olaf Monien
License: MIT

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.