update documentation to be in markdown format.

probably some improvements can be done to this, but seems in general
to look ok now!