API method doc, rewritten shepherd