optimized comments for api doc