Skip to content

Add Enum, Mailer and Form conventions to Structure & Conventions#8287

Open
dereuromark wants to merge 1 commit into5.xfrom
docs-conventions-modern-elements
Open

Add Enum, Mailer and Form conventions to Structure & Conventions#8287
dereuromark wants to merge 1 commit into5.xfrom
docs-conventions-modern-elements

Conversation

@dereuromark
Copy link
Copy Markdown
Member

Summary

Extend docs/en/intro/conventions.md to cover modern CakePHP 5.x application classes that were missing from the Structure & Conventions page:

  • Enum (src/Model/Enum/) — new ArticleStatus code example, PSR-4 row, reference table row, and entry in the file tree diagram plus the SQL example
  • Mailer (src/Mailer/*Mailer.php) — added to the src/ directory table and PSR-4 naming table
  • Form (src/Form/*Form.php) — added to the src/ directory table and PSR-4 naming table

Also:

  • Fix Enum docs anchor link (#enum-type) to match the actual heading in orm/database-basics.md
  • Replace misleading created_at column example with is_processed (CakePHP defaults to created / modified, which is what the Complete Example SQL uses)

Extend conventions.md with Enum, Mailer and Form class conventions so
the page reflects current CakePHP 5.x application structure:

- Add Enum class example (src/Model/Enum/ArticleStatus) with file path,
  PSR-4 row, reference table row, file tree entry and SQL column example
- Add Form (src/Form/*Form.php) and Mailer (src/Mailer/*Mailer.php) to
  the src/ directory table and the PSR-4 naming table
- Fix Enum docs anchor (#enum-type) and replace misleading created_at
  column example with is_processed (CakePHP defaults to created/modified)
@dereuromark dereuromark added this to the 5.x milestone Apr 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant