edits for clarity and terminology
api: adding introduction docs