Skip to content
This repository was archived by the owner on May 5, 2020. It is now read-only.

Latest commit

 

History

History
67 lines (42 loc) · 1.85 KB

overview.rst

File metadata and controls

67 lines (42 loc) · 1.85 KB

Contributing to the Documentation

Documentation is as important as code. It follows the exact same principles: DRY, tests, ease of maintenance, extensibility, optimization, and refactoring just to name a few. And of course, documentation has bugs, typos, hard to read tutorials, and more.

Contributing

Before contributing, you need to become familiar with the :doc:`markup language <format>` used by the documentation.

The Symfony2 documentation is hosted on GitHub:

https://github.com/symfony/symfony-docs

If you want to submit a patch, fork the official repository on GitHub and then clone your fork:

$ git clone git://github.com/YOURUSERNAME/symfony-docs.git

Next, create a dedicated branch for your changes (for organization):

$ git checkout -b improving_foo_and_bar

You can now make your changes directly to this branch and commit them. When you're done, push this branch to your GitHub fork and initiate a pull request. The pull request will be between your improving_foo_and_bar branch and the symfony-docs master branch.

/images/docs-pull-request.png

GitHub covers the topic of pull requests in detail.

Note

The Symfony2 documentation is licensed under a Creative Commons Attribution-Share Alike 3.0 Unported :doc:`License <license>`.

Reporting an Issue

The most easy contribution you can make is reporting issues: a typo, a grammar mistake, a bug in code example, a missing explanation, and so on.

Steps:

  • Submit a bug in the bug tracker;
  • (optional) Submit a patch.

Translating

Read the dedicated :doc:`document <translations>`.