added untested `clean` implementation
added `endpoint` function, untested
added `endpoint` docs