docs(reference): add controller API documentation

closes #1490 

ping @Joshua-Anderson, as I know he's been asking for this.