[IMP] mail docs

* fill-paragraph
* remove sections referring to removed methods with no obvious replacement
[IMP] gamification: improve the name of some m2m relations