add extra documentation for API