Contributing Documentation (Symfony Docs)

The Symfony documentation is as open as the code. Fixing a typo, clarifying a confusing paragraph or documenting a new feature are all valuable contributions.
Small fix? Click Edit this page on any documentation page and propose the change directly on GitHub. Larger change? Fork symfony/symfony-docs, branch off 6.4 (the oldest maintained branch), edit the .rst files, and open a pull request against 6.4.
Before you start, you need a free GitHub account and a basic familiarity with the reStructuredText format used by the docs (see the format guide for a quick overview).
For a small change like a typo or rewording, the fastest way is to edit the file directly on GitHub, without installing anything:
Click the Edit this page button at the top of the documentation page:
Edit the contents (the first time, GitHub asks you to fork the repository). Then describe your change and click Propose changes:
For anything larger, or if you prefer to work on your own computer, use the local workflow below.
Which branch should I use? Base your pull request on the right branch so it can be merged without extra work:
You only pick the branch once, when creating your topic branch. Everything else in this guide works the same regardless of the branch you chose.
Fork the symfony/symfony-docs repository (you only do this once) and clone your fork:
Add the original repository as a remote called upstream and create a branch for your changes based on the branch you chose (use fix_XXX for reported issues, where XXX is the issue number):
Make your changes following the Documentation Standards, then commit and push them to your fork:
If reviewers ask for changes, don't open a new pull request. Commit on the same branch and push again; the pull request updates automatically:
When you open the pull request, automated checks look for common errors (syntax issues, broken links, typos), so you don't need to install anything to validate your changes. If you prefer to build the documentation locally to debug issues or read it offline, follow the instructions in the README of the symfony-docs repository.
Once merged, your changes appear on the Symfony website within a few hours, and you join the Symfony Documentation Contributors list.
Like the code, the documentation is split into branches matching the maintained Symfony versions. Basing fixes on the oldest maintained branch (6.4) lets the documentation team apply them to all newer branches automatically. Only base your change on a newer branch when you're documenting a feature introduced there.
Yes. Open it as a draft pull request so reviewers know it's still in progress. If you're documenting a feature that hasn't been merged into the core code yet, mention it: the PR won't be merged until the code is.
Make sure the changes are related; otherwise, split them into separate pull requests. Before submitting a large change, it's a good idea to open an issue first to check that the documentation team agrees with your proposal, so you don't waste your time.
The official Symfony documentation is published only in English. You can read about the reasons in this blog post.
We have taken steps to improve the experience when using Google Translate to prevent code blocks from being translated. To translate any page, copy its URL and paste it into the form on the Google Translate site.
Contributing translations of Symfony's built-in messages (validation errors, security messages, etc.) is a different task, explained in Contributing Translations.
The Symfony documentation is licensed under a Creative Commons Attribution-Share Alike 3.0 Unported License (CC BY-SA 3.0).
You are free to share (copy, distribute and transmit) and to remix (adapt) the work, under the following conditions:
This is a human-readable summary of the Legal Code (the full license). Check out the license of the Symfony code and other Symfony licenses and trademarks.
Check Code Performance in Dev, Test, Staging & Production
Be safe against critical risks to your projects and businesses
Thanks Marco Lipparini (@liarco) for being a Symfony contributor
2 commits • 11 lines changed
View all contributors that help us make Symfony
Be an active part of the community and contribute ideas, code and bug fixes. Both experts and newcomers are welcome.
Symfony™ is a trademark of Symfony SAS. All rights reserved.