completing api docs

adding the missing paragraphs and some formatting
Allow single quoted attributes
Close #309