docs: fix sphinx warnings from new package documentation

No new warning categories are introduced by adding feast.aggregation, feast.dbt, and feast.openlineage to the Sphinx docs. The 10 new "more than one target found" warnings follow the same pre-existing pattern (8 already present) caused by feast.__init__ re-exporting classes under multiple paths. Fixes applied: - Remove :undoc-members: from dataclass automodules (Aggregation, IRMetadata, OpenLineageConfig) to prevent duplicate attribute docs - Document re-exporting __init__ packages at package level only to avoid duplicate descriptions from submodule entries - Fix markdown-style code fences in openlineage/__init__.py docstring - Fix RST formatting in client.py Example section (Example::) and emitter.py ASCII art diagram (literal block) - Fix repo_config.py field docstring that triggered an ambiguous OpenLineageConfig cross-reference Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Signed-off-by: Alex Korbonits <alex@korbonits.com>
franciscojavierarceo · Apr 15, 2026 · Apr 13, 2026 · Apr 13, 2026 · Apr 14, 2026 · Apr 14, 2026
commit a1099d63c3dc606ec1c7b0c4bed02a01c234ff34
diff --git a/sdk/python/docs/source/feast.aggregation.rst b/sdk/python/docs/source/feast.aggregation.rst
@@ -14,5 +14,4 @@ Module contents
 
 .. automodule:: feast.aggregation
    :members:
-   :undoc-members:
    :show-inheritance:
diff --git a/sdk/python/docs/source/feast.aggregation.tiling.rst b/sdk/python/docs/source/feast.aggregation.tiling.rst
@@ -1,37 +1,9 @@
 feast.aggregation.tiling package
 =================================
 
-Submodules
-----------
-
-feast.aggregation.tiling.base module
--------------------------------------
-
-.. automodule:: feast.aggregation.tiling.base
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-feast.aggregation.tiling.orchestrator module
---------------------------------------------
-
-.. automodule:: feast.aggregation.tiling.orchestrator
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-feast.aggregation.tiling.tile\_subtraction module
--------------------------------------------------
-
-.. automodule:: feast.aggregation.tiling.tile_subtraction
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
 Module contents
 ---------------
 
 .. automodule:: feast.aggregation.tiling
    :members:
-   :undoc-members:
    :show-inheritance:
diff --git a/sdk/python/docs/source/feast.openlineage.rst b/sdk/python/docs/source/feast.openlineage.rst
@@ -1,53 +1,9 @@
 feast.openlineage package
 =========================
 
-Submodules
-----------
-
-feast.openlineage.client module
---------------------------------
-
-.. automodule:: feast.openlineage.client
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-feast.openlineage.config module
---------------------------------
-
-.. automodule:: feast.openlineage.config
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-feast.openlineage.emitter module
----------------------------------
-
-.. automodule:: feast.openlineage.emitter
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-feast.openlineage.facets module
---------------------------------
-
-.. automodule:: feast.openlineage.facets
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-feast.openlineage.mappers module
----------------------------------
-
-.. automodule:: feast.openlineage.mappers
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
 Module contents
 ---------------
 
 .. automodule:: feast.openlineage
    :members:
-   :undoc-members:
    :show-inheritance:
diff --git a/sdk/python/docs/source/feast.rst b/sdk/python/docs/source/feast.rst
@@ -25,14 +25,6 @@ Subpackages
 Submodules
 ----------
 
-feast.aggregation module
-------------------------
-
-.. automodule:: feast.aggregation
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
 feast.arrow\_error\_handler module
 ----------------------------------
 

diff --git a/sdk/python/feast/openlineage/__init__.py b/sdk/python/feast/openlineage/__init__.py
@@ -35,27 +35,27 @@
 Usage:
     Simply configure OpenLineage in your feature_store.yaml:
 
-    ```yaml
-    project: my_project
-    # ... other config ...
-
-    openlineage:
-      enabled: true
-      transport_type: http
-      transport_url: http://localhost:5000
-      transport_endpoint: api/v1/lineage
-      namespace: my_namespace  # Optional: defaults to project name
-    ```
+    .. code-block:: yaml
+
+        project: my_project
+        # ... other config ...
+
+        openlineage:
+          enabled: true
+          transport_type: http
+          transport_url: http://localhost:5000
+          transport_endpoint: api/v1/lineage
+          namespace: my_namespace  # Optional: defaults to project name
 
     Then use Feast normally - lineage events are emitted automatically!
 
-    ```python
-    from feast import FeatureStore
+    .. code-block:: python
+
+        from feast import FeatureStore
 
-    fs = FeatureStore(repo_path="feature_repo")
-    fs.apply([entity, feature_view, feature_service])  # Emits lineage
-    fs.materialize(start, end)  # Emits START/COMPLETE/FAIL events
-    ```
+        fs = FeatureStore(repo_path="feature_repo")
+        fs.apply([entity, feature_view, feature_service])  # Emits lineage
+        fs.materialize(start, end)  # Emits START/COMPLETE/FAIL events
 """
 
 from feast.openlineage.client import FeastOpenLineageClient

diff --git a/sdk/python/feast/openlineage/client.py b/sdk/python/feast/openlineage/client.py
@@ -55,7 +55,8 @@ class FeastOpenLineageClient:
     from Feast operations like materialization, feature retrieval, and
     registry changes.
 
-    Example:
+    Example::
+
         from feast.openlineage import FeastOpenLineageClient, OpenLineageConfig
 
         config = OpenLineageConfig(

diff --git a/sdk/python/feast/openlineage/emitter.py b/sdk/python/feast/openlineage/emitter.py
@@ -644,11 +644,13 @@ def emit_apply(
         1. feast_feature_views_{project}: DataSources + Entities → FeatureViews
         2. feast_feature_services_{project}: FeatureViews → FeatureServices
 
-        This creates a lineage graph matching Feast UI:
+        This creates a lineage graph matching Feast UI::
+
             DataSource ──→ FeatureView ──→ FeatureService
                  ↑
               Entity
 
+
         Args:
             objects: List of Feast objects being applied
             project: Project name

diff --git a/sdk/python/feast/repo_config.py b/sdk/python/feast/repo_config.py
@@ -337,7 +337,7 @@ class RepoConfig(FeastBaseModel):
     """ MaterializationConfig: Configuration options for feature materialization behavior. """
 
     openlineage_config: Optional[OpenLineageConfig] = Field(None, alias="openlineage")
-    """ OpenLineageConfig: Configuration for OpenLineage data lineage integration (optional). """
+    """ Configuration for OpenLineage data lineage integration (optional). """
 
     def __init__(self, **data: Any):
         super().__init__(**data)