Move docs to repo

As asked on IRC.

Moved over with updated filenames, headings and cross-references.

Will do another PR when this is merged with some much needed cleanup and fixes.