Nicer comments.
Fixed up markdown in the specs