Symfony News

A month of Symfony Documentation #4 (March 2015)

With Symfony 2.7 feature freeze at the end of this month, lots of documentation about new features were merged. Besides this, the doc team focussed on fixing some issues and following the best practices.

New Documentation

Thomas Royer updated the whole documentation to use the shortcut methods that were added to the base Controller in Symfony 2.6. Among other methods, redirectToRoute(), denyAccessUnlessGranted() and addFlash() are now used in the documentation. He also made sure to remove the "magic" by documenting the long alternative in comments in the code.

David Buchmann also documented the base Controller methods, but now in the Controllers as Services article. He documented the required services and the code to use to replicate the methods yourself. This way, people no longer have to search trough Symfony source code when using controllers as services.

Javier Eguiluz and Wouter de Jong added two new best practices about custom form field types and template naming. Meanwhile, the Testing, Validation, Propel and HTTP cache book recipes were updated to follow the best practices.

The colors of the query count are now documented as well by "XitasoChris".

Helping during the Stabilisation Phase

With Symfony 2.7 now in stabilisation phase, the documentation team would like to get your help with documenting the missing bits. All issues that should be fixed before 2.7 is released can be found in the 2.7 milestone. These issues often contain a good explanation and aren't very hard to document. We hope to write your name in the overview of April!

Documentation Activity

This month, 67 PRs were merged and 23 new PRs were proposed. In total, the documentation recieved 2840 additions and 1445 deletions. This is made possible by the help of 53 different contributors.

A full list of changes can be found in the changelog.

The documentation is maintained by Ryan Weaver, Christian Flothmann and Wouter de Jong. The documentation repository can be found on GitHub.


Be trained by Symfony experts - 2015-04-13 Clichy - 2015-04-14 London - 2015-04-14 London


About us

What a Symfony developer should know about the framework: News, Jobs, Tweets, Events, Videos,...

Resources

Find us on Twitter

Find us on Facebook