foundation for api doc #23