improve doc
Merge pull request #102 from FriendsOfSymfony/doc-cleanups

improve doc