completing api docs

adding the missing paragraphs and some formatting