Documentations improvements.

Dropped markdown in favor of straight HTML.
Fixed some more documentation comments.