Extbase Documentation Overhaul: Status Report

Earlier this year, TYPO3 Association members voted to fund an overhaul of the Extbase documentation. Work started in May. Here is where things stand.

The existing Extbase docs carry years of accumulated contributions, but the framework had moved on and the docs had become hard to navigate — especially for developers approaching Extbase for the first time or returning after a gap. The overhaul replaces them with documentation that is accurate for TYPO3 v14, follows a structure, and is written for both new and experienced Extbase developers.

The chapters have been rebuilt from the ground up. What you can read right now:

• The quick start that takes a developer to a working extension in nine concrete steps without any fluff.
• A concepts section on how MVC and persistence work in Extbase specifically.
• Full reference chapters on domain models, repositories, controllers, property mapping, views, validation, and plugin and module registration.

Common questions are answered where the reader is rather than in a separate appendix. For example the elusive storagePid explanation lives on the repository page — not three clicks away. The new v14 PHP attributes (#[Authorize], #[RateLimit], #[Validate]) are documented properly for the first time.

The work continues through August. Routing, historically the most confusing part of Extbase, gets a full chapter with concrete examples. Persistence, Caching, Configuration, and Security will follow.

The documentation includes a growing Common Pitfalls appendix. If you have hit a wall with Extbase, found the answer, and thought “This should really be documented,” please open an issue or pull request on GitHub. Your experience is exactly what the appendix is built for.

• Extbase documentation (live, work in progress)
• GitHub: TYPO3CMS-Reference-CoreApi