Updated documentation.

Github's markdown parser apparently can't figure out comments correctly.