clarify concept, add API and Timeout sections, remove connectionId for connections, further small edits