fixing markdown, a few wording improvements, sketch of Auth section