[Python] Update Sphinx docs (#3791)

## 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

Author: kanterov

experimental/python/docs/conf.py

@@ -16,7 +16,6 @@
 project = "databricks-bundles"
 copyright = "2024, Databricks"
 author = "Gleb Kanterov"
-release = "beta"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

experimental/python/docs/databricks.bundles.core.rst

@@ -38,4 +38,7 @@ Methods
 Decorators
 -----------
 .. autodecorator:: databricks.bundles.core.job_mutator
+.. autodecorator:: databricks.bundles.core.pipeline_mutator
+.. autodecorator:: databricks.bundles.core.schema_mutator
+.. autodecorator:: databricks.bundles.core.volume_mutator
 .. autodecorator:: databricks.bundles.core.variables

experimental/python/docs/databricks.bundles.schemas.rst

@@ -0,0 +1,11 @@
+Schemas
+===============================
+
+.. currentmodule:: databricks.bundles.schemas
+
+**Package:** ``databricks.bundles.schemas``
+
+Classes
+---------------
+
+.. automodule:: databricks.bundles.schemas

experimental/python/docs/databricks.bundles.volumes.rst

@@ -0,0 +1,11 @@
+Volumes
+===============================
+
+.. currentmodule:: databricks.bundles.volumes
+
+**Package:** ``databricks.bundles.volumes``
+
+Classes
+---------------
+
+.. automodule:: databricks.bundles.volumes

experimental/python/docs/index.rst

@@ -1,4 +1,4 @@
-databricks-bundles (Beta)
+databricks-bundles
 --------------------------------
 
 `databricks-bundles` package implements Python support for Databricks Asset Bundles.
@@ -12,3 +12,5 @@ See `What is Python support for Databricks Asset Bundles? (TBD) <#>`_.
    databricks.bundles.core
    databricks.bundles.jobs
    databricks.bundles.pipelines
+   databricks.bundles.schemas
+   databricks.bundles.volumes