Add documentation about assumptions
Some CS
proofreading
Merge pull request #184 from marmelab/add_doc_assumptions

[RFR] Add doc about assumptions