Add documentation for schemas

[snuyanzin]

fixes #498

cc @panilya since you've asked about it

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 91.85%. Comparing base (2d6ebd5) to head (95f4a67).
Report is 1196 commits behind head on main.

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@             Coverage Diff              @@
##               main     #533      +/-   ##
============================================
- Coverage     91.91%   91.85%   -0.06%     
+ Complexity     2359     2357       -2     
============================================
  Files           247      247              
  Lines          4948     4949       +1     
  Branches        530      530              
============================================
- Hits           4548     4546       -2     
- Misses          272      273       +1     
- Partials        128      130       +2     

☔ View full report in Codecov by Sentry.
📢 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.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.