correct spelling errors and typos in documentation.
add warning about silex migration.
Merge pull request #12 from bangpound/docs

Improve documentation