first iteration of the new sphinx based documentation for the API