minor_changes:
  - documentation construction now gives more information on error.