changing docs to a more API style