just adding some comments in client api`