rewritte old proposal api documentation to markdown

yeah, sounds better, thanks