documentation for cleaned up routing
documenting the limit on candidates
adjust for simplecms routing refactoring
make comment on limit_candidates a caution
Merge pull request #430 from symfony-cmf/routing-configuration

documentation for cleaned up routing