[Python] Update Sphinx docs

[kanterov]

Changes

Update Sphinx docs with missing documentation for schemas and volumes.

See also #3791

Why

These docs are published on GitHub pages and are used by humans and AI agents

Tests

Using pre-commit check, generating docs, and inspecting the generated output manually

[eng-dev-ecosystem-bot]

Run: 18681259771

	Env	🔄​flaky	💚​RECOVERED	🙈​SKIP	✅​pass	🙈​skip
💚​	aws linux		1	1	321	561
🔄​	aws windows	4	1	1	318	560
💚​	aws-ucws linux		1	1	437	457
💚​	aws-ucws windows		1	1	438	456
💚​	azure linux		1	1	321	560
💚​	azure windows		1	1	322	559
💚​	azure-ucws linux		1	1	437	456
💚​	azure-ucws windows		1	1	438	455
🔄​	gcp linux	8	1	1	312	562
🔄​	gcp windows	6	1	1	315	561

18 failing tests:

Test Name	aws linux	aws windows	aws-ucws linux	aws-ucws windows	azure linux	azure windows	azure-ucws linux	azure-ucws windows	gcp linux	gcp windows
TestAccept	💚​R	💚​R	💚​R	💚​R	💚​R	💚​R	💚​R	💚​R	💚​R	💚​R
TestAccept/bundle/deploy/files/no-snapshot-sync	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f
TestAccept/bundle/deploy/files/no-snapshot-sync/DATABRICKS_BUNDLE_ENGINE=direct-exp	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f
TestAccept/bundle/resources/experiments/basic	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p
TestAccept/bundle/resources/experiments/basic/DATABRICKS_BUNDLE_ENGINE=terraform	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p
TestAccept/bundle/resources/jobs/double-underscore-keys	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p
TestAccept/bundle/resources/jobs/double-underscore-keys/DATABRICKS_BUNDLE_ENGINE=direct-exp	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p
TestAccept/bundle/resources/jobs/fail-on-active-runs	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p
TestAccept/bundle/resources/jobs/fail-on-active-runs/DATABRICKS_BUNDLE_ENGINE=terraform	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p
TestAccept/bundle/resources/models/basic	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	🔄​f
TestAccept/bundle/resources/models/basic/DATABRICKS_BUNDLE_ENGINE=direct-exp	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f
TestAccept/bundle/resources/models/basic/DATABRICKS_BUNDLE_ENGINE=terraform	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p
TestAccept/bundle/run/app-with-job	🙈​S	🙈​S	🙈​S	🙈​S	🙈​S	🙈​S	🙈​S	🙈​S	🙈​S	🙈​S
TestAccept/bundle/templates/default-python/combinations/classic	✅​p	🔄​f	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f
TestAccept/bundle/templates/default-python/combinations/classic/DATABRICKS_BUNDLE_ENGINE=direct-exp/DLT=no/NBOOK=yes/PY=yes	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f
TestAccept/bundle/templates/default-python/combinations/classic/DATABRICKS_BUNDLE_ENGINE=terraform/DLT=yes/NBOOK=yes/PY=yes	✅​p	🔄​f	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p
TestAccept/bundle/templates/default-python/integration_classic	✅​p	🔄​f	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p
TestAccept/bundle/templates/default-python/integration_classic/DATABRICKS_BUNDLE_ENGINE=terraform/UV_PYTHON=3.11	✅​p	🔄​f	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p