Amend existing docs and add missing docs
This adds a small paragraph when errors are returned and adds documentation which was accidentally skipped in !10 (merged).
This adds a small paragraph when errors are returned and adds documentation which was accidentally skipped in !10 (merged).