slightly better api description