Schema catalog static site and GitHub Pages

[yatharthranjan]

Summary

This PR adds a static HTML data source catalog generated from commons/ and specifications/, plus a workflow to publish it to GitHub Pages when master is updated (path-filtered).

Changes

• scripts/generate_schema_catalog.py — Builds the catalog: sections by data source (Garmin, Fitbit, Apple Health, etc.), one measurements table per source (with empty columns omitted per source), merged Avro field list with common metadata fields omitted, latest aRMT spec only, Apple Health / HealthKit extra block, search and styling.
• .github/workflows/schema-catalog-pages.yml — Install PyYAML, run the generator to _site, deploy via actions/deploy-pages (push to master only for deploy; PRs validate the build).
• requirements-docs.txt — PyYAML for the script.
• .gitignore — __pycache__/, *.py[cod], existing entries for _site/ and .venv-docs/.

Follow-up

Enable GitHub Pages with source GitHub Actions in repo settings if not already configured.

How to test locally

python3 -m venv .venv-docs && .venv-docs/bin/pip install -r requirements-docs.txt
.venv-docs/bin/python scripts/generate_schema_catalog.py --out _site
# open _site/index.html

Example screenshot of the generated site -

[afolarin]

Very nice.
Should we give a similar treatment to the info in specifications ?

[afolarin]

LGTM

[afolarin]

Perhaps also needs a link to the page static page placed into the Schema repo README.md

[mpgxvii]

Nice! LGTM.

[yatharthranjan]

Should we give a similar treatment to the info in specifications ?

this combines info from both specs and schemas (you can see specification links at top of each source table)

Perhaps also needs a link to the page static page placed into the Schema repo README.md

Thanks, yes good idea, will add.