Improve schema docs and regenerate schemas automatically

[MJGaughran]

In preparation for the module creation docs, here we fix some schema documentation and create a pre-commit hook to regenerate the schemas.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.48%. Comparing base (cd61d8d) to head (9d6c8b0).

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #76   +/-   ##
=======================================
  Coverage   99.48%   99.48%           
=======================================
  Files          27       27           
  Lines         979      979           
=======================================
  Hits          974      974           
  Misses          5        5           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.