This repository holds the content of the book Symfony: The Fast Track, the official guide to building a Symfony application step by step.
Files are stored as <version>/<locale>/*.rst, for example
8.1/en/7-database.rst:
<version>is the Symfony version the edition targets (e.g.8.1).<locale>is the language code (e.g.en,fr,de).- English (
en) is the source language: every other locale is a translation of it.
Code, directives, references, and file paths are identical across all locales of a given version; only the prose differ.
We welcome contributions, but please read the rules below before opening a pull request. They keep the book consistent and reviewable across all languages.
All contributions must target the latest book version. Older versions are no longer maintained once a newer one is released.
- Tweaking and polishing existing translations is exactly what we are looking for.
- Only contribute to a language if you are a native speaker.
- A translation change is merged only after a few approvals from native speakers.
- Improving the English source is welcome too, just like any other language.
- Fixing bugs in the content is welcome.
- Code changes cannot be done easily by contributors, so please open an issue to discuss them first.
- No new translation language is allowed by default; we only maintain the existing ones.
- Exceptions are possible but must be validated by the core team in a ticket after discussion.
- Changing the content or adding new chapters is not allowed.
- If you have an idea, open an issue to discuss it.
- LLM contributions are not allowed by default, in particular automated translations.
This work, including the code samples, is licensed under a Creative Commons BY-NC-SA 4.0 license.
