better api comments