Improve documentation

This pull request corrects various typos and spelling errors and adds a warning for developers migrating an application from Silex.