rewritte old proposal api documentation to markdown

good catch