[RFR] Add doc about assumptions

Fixes #183