what do you think about addign a link to http://symfony.com/bc so that people can see what is causing a BC break exactly ? Some changes are causing BC breaks while it is not obvious at first. The Symfony team did a great work at identifying all these cases and documenting them (the BC is documented in the ``API`` column. Normal classes in Symfony are classes for which some BC breaks are actually allowed, but not all of them)