issue #5 - cosmetic edits to API doc