We agreed :-) that Adrian would prepare an initial example (MC 'item' of his choice) in user guide and reference documentation.
Example would focus on trying to explain usage (user guide) and more technical stuff (reference) through short text / comment, educational example and perhaps some code explaining the stuff in more details.
Being fancy is not priority. :-)
Next parts of documentation should follow the initial example structure, giving us uniform look of MC documentation.