various tweaks and cleanups
Merge pull request #116 from FriendsOfSymfony/refactor-docs-dbu

various tweaks and cleanups