started refining api documentation