move to markdown and document basic auth