Updated API documentation with further comments