Moved documentation back into the project, from the wiki.

Please add comments on the wiki or as issues and I will transfer them
to the documentation.
Added README with instructions on how to compile the documentation