added endpoints docs (first draft)