completing api docs

adding the missing paragraphs and some formatting
Investigating Sauce Labs issues - DO NOT MERGE