fixes to markdown and documentation