Needs proper docs

stuff like "The endpoint keyword" just gets a mention on the front page/readme with no further detail