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.
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,
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`_".
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!
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.
Comments are closed.
To ensure that comments stay relevant, they are closed for old posts.