markdown and improving docs