initial documentation for the api