initial documentation of new api