more revision of apidocs