Improve/Rewrite MCMP documentation

This should include information on: 

* which parts are parsed first
* which are the error messages users can get
* how conflicts are handled
* clarify all the undefined behaviours we've gathered