It's documented here: http://symfony.com/doc/current/contributing/documentation/overview.html#documenting-new-features-or-behavior-changes