adding additional docs describing #endpoints method