port user docs to markdown; update README