Moved documentation related files to doc

Closes #16. Moved all documentation related files to `doc` folder. The
HTML documentation is now being generated into `doc/html`. Fixed a lot
documentation issues along the way.