a lot of edits to markdown and script