Platform: another round of insane documentation updates.

Each class should now have *everything* needed in its documentation,
nothing is left out. Most of the text was taken from README in
magnum-bootstrap repository.
doc: use absolute includes.

This somehow slipped through.