[Best Practices] weird link captions in cross references

[dbu]

The best practices articles have many places where a cross reference uses the full title of a cookbook entry or doc chapter, making for weird grammar: "If you need to execute some code before or after the execution of your controllers, you can use the EventDispatcher component to How to Setup before and after Filters." for example, http://symfony.com/doc/2.3/best_practices/controllers.html#pre-and-post-hooks

almost every section has one of those links. not harmful, but a bit confusing.

[javiereguiluz]

@dbu I agree that these cross references are pretty bad. Thanks for reporting it!

I'll take care of fixing this issue.

[wouterj]

I always prefer to use quotes when referencing articles: If you need to execute some code before or after the execution of your controllers, you can use the EventDispatcher component to "How to Setup before and after Filters".

However, I know @weaverryan isn't a big fan of this

[xabbuh]

@wouterj At least, imho you example doesn't read really better. I would prefer to set the link text manually here.