Add DPH docs

.secrets.baseline

@@ -3,7 +3,7 @@
     "files": "^.secrets.baseline$",
     "lines": null
   },
-  "generated_at": "2026-04-09T04:39:13Z",
+  "generated_at": "2026-05-11T09:05:52Z",
   "plugins_used": [
     {
       "name": "AWSKeyDetector"
@@ -301,6 +301,66 @@
         "verified_result": null
       }
     ],
+    "docs/chapters/05_dph_services/overview.rst": [
+      {
+        "hashed_secret": "45d676e7c6ab44cf4b8fa366ef2d8fccd3e6d6e6",
+        "is_secret": false,
+        "is_verified": false,
+        "line_number": 123,
+        "type": "Secret Keyword",
+        "verified_result": null
+      }
+    ],
+    "docs/chapters/05_dph_services/usage_guide.rst": [
+      {
+        "hashed_secret": "11fa7c37d697f30e6aee828b4426a10f83ab2380",
+        "is_secret": false,
+        "is_verified": false,
+        "line_number": 63,
+        "type": "Secret Keyword",
+        "verified_result": null
+      }
+    ],
+    "docs/chapters/06_odcs_generator/collibra_integration.rst": [
+      {
+        "hashed_secret": "564e340cd48437d2dfe876ee154cc99dc4d0d137",
+        "is_secret": false,
+        "is_verified": false,
+        "line_number": 97,
+        "type": "Secret Keyword",
+        "verified_result": null
+      }
+    ],
+    "docs/chapters/06_odcs_generator/examples.rst": [
+      {
+        "hashed_secret": "564e340cd48437d2dfe876ee154cc99dc4d0d137",
+        "is_secret": false,
+        "is_verified": false,
+        "line_number": 61,
+        "type": "Secret Keyword",
+        "verified_result": null
+      }
+    ],
+    "docs/chapters/06_odcs_generator/index.rst": [
+      {
+        "hashed_secret": "564e340cd48437d2dfe876ee154cc99dc4d0d137",
+        "is_secret": false,
+        "is_verified": false,
+        "line_number": 93,
+        "type": "Secret Keyword",
+        "verified_result": null
+      }
+    ],
+    "docs/chapters/06_odcs_generator/informatica_integration.rst": [
+      {
+        "hashed_secret": "564e340cd48437d2dfe876ee154cc99dc4d0d137",
+        "is_secret": false,
+        "is_verified": false,
+        "line_number": 77,
+        "type": "Secret Keyword",
+        "verified_result": null
+      }
+    ],
     "examples/auth_provider_usage.py": [
       {
         "hashed_secret": "df5cc5832dc34a455c18662ac84587ea19cf2435",

docs/api/data_product_recommender/index.rst

@@ -18,49 +18,28 @@
 Data Product Recommender Reference
 ===================================
 
-Class reference for the Data Product Recommender module.
+The data product recommender module provides query-log analysis and platform-specific parsers.
 
 Core Classes
 ------------
 
-.. currentmodule:: wxdi.data_product_recommender.recommender
-
-.. autoclass:: DataProductRecommender
+.. automodule:: wxdi.data_product_recommender.recommender
    :members:
    :undoc-members:
    :show-inheritance:
 
 Platform Parsers
 ----------------
 
-.. currentmodule:: wxdi.data_product_recommender.platforms
-
-.. autoclass:: SnowflakeQueryParser
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. autoclass:: DatabricksQueryParser
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. autoclass:: BigQueryQueryParser
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. autoclass:: WatsonxDataQueryParser
+.. automodule:: wxdi.data_product_recommender.platforms
    :members:
    :undoc-members:
    :show-inheritance:
 
 Base Classes
 ------------
 
-.. currentmodule:: wxdi.data_product_recommender.base
-
-.. autoclass:: QueryLogParser
+.. automodule:: wxdi.data_product_recommender.base
    :members:
    :undoc-members:
    :show-inheritance:

docs/api/dph_services/core.rst

@@ -18,40 +18,20 @@
 Core Classes
 ============
 
-Main service class and data models for Data Product Hub Services.
+The core DPH services API provides the main service client and its available operations.
+
+.. currentmodule:: wxdi.dph_services.dph_v1
 
 DphV1 Service
 -------------
 
-.. currentmodule:: wxdi.dph_services
+DphV1
+~~~~~
 
-.. autoclass:: DphV1
+.. autoclass:: wxdi.dph_services.dph_v1.DphV1
    :members:
    :undoc-members:
    :show-inheritance:
    :inherited-members:
 
-Common Models
--------------
-
-.. autoclass:: wxdi.dph_services.common.DataProduct
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. autoclass:: wxdi.dph_services.common.DataProductDraft
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. autoclass:: wxdi.dph_services.common.ContractTerms
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. autoclass:: wxdi.dph_services.common.Domain
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
 .. Made with Bob

docs/api/dph_services/index.rst

@@ -18,91 +18,29 @@
 DPH Services API
 ================
 
-API reference for the Data Product Hub Services module.
+The DPH services module provides the main client for Data Product Hub Services operations.
 
 .. toctree::
    :maxdepth: 2
 
    core
 
+.. currentmodule:: wxdi.dph_services.dph_v1
+
 Main Service Class
 ------------------
 
-.. currentmodule:: wxdi.dph_services
+DphV1
+~~~~~
+
+The DphV1 class provides access to all Data Product Hub Services operations.
+For detailed API reference including all methods, see :ref:`api_dph_services_core`.
 
-.. autoclass:: DphV1
+.. autoclass:: wxdi.dph_services.dph_v1.DphV1
    :members:
    :undoc-members:
    :show-inheritance:
    :special-members: __init__
-
-Container Operations
---------------------
-
-.. automethod:: DphV1.initialize
-.. automethod:: DphV1.get_initialize_status
-.. automethod:: DphV1.get_service_id_credentials
-.. automethod:: DphV1.manage_api_keys
-
-Data Product Operations
------------------------
-
-.. automethod:: DphV1.create_data_product
-.. automethod:: DphV1.list_data_products
-.. automethod:: DphV1.list_data_products_with_pager
-.. automethod:: DphV1.get_data_product
-.. automethod:: DphV1.update_data_product
-.. automethod:: DphV1.delete_data_product
-
-Draft Operations
-----------------
-
-.. automethod:: DphV1.create_data_product_draft
-.. automethod:: DphV1.list_data_product_drafts
-.. automethod:: DphV1.get_data_product_draft
-.. automethod:: DphV1.update_data_product_draft
-.. automethod:: DphV1.delete_data_product_draft
-.. automethod:: DphV1.publish_data_product_draft
-
-Release Operations
-------------------
-
-.. automethod:: DphV1.list_data_product_releases
-.. automethod:: DphV1.get_data_product_release
-.. automethod:: DphV1.update_data_product_release
-.. automethod:: DphV1.retire_data_product_release
-
-Contract Terms Operations
--------------------------
-
-.. automethod:: DphV1.create_draft_contract_terms_document
-.. automethod:: DphV1.get_data_product_draft_contract_terms
-.. automethod:: DphV1.update_draft_contract_terms_document
-.. automethod:: DphV1.delete_draft_contract_terms_document
-
-Domain Operations
------------------
-
-.. automethod:: DphV1.list_data_product_domains
-.. automethod:: DphV1.create_data_product_domain
-.. automethod:: DphV1.create_data_product_subdomain
-.. automethod:: DphV1.get_domain
-.. automethod:: DphV1.update_data_product_domain
-.. automethod:: DphV1.delete_domain
-
-Asset Visualization Operations
--------------------------------
-
-.. automethod:: DphV1.create_data_asset_visualization
-.. automethod:: DphV1.reinitiate_data_asset_visualization
-
-Contract Template Operations
-----------------------------
-
-.. automethod:: DphV1.create_contract_template
-.. automethod:: DphV1.list_data_product_contract_template
-.. automethod:: DphV1.get_contract_template
-.. automethod:: DphV1.update_data_product_contract_template
-.. automethod:: DphV1.delete_data_product_contract_template
+   :no-index:
 
 .. Made with Bob

docs/api/odcs_generator/index.rst

@@ -18,34 +18,38 @@
 ODCS Generator Reference
 ========================
 
-Class reference for the ODCS Generator module.
+The ODCS generator module provides integrations for generating ODCS YAML from supported catalog platforms.
+
+.. currentmodule:: wxdi.odcs_generator.generate_odcs_from_collibra
 
 Collibra Integration
 --------------------
 
-.. currentmodule:: wxdi.odcs_generator.generate_odcs_from_collibra
+CollibraClient
+~~~~~~~~~~~~~~
 
-.. autoclass:: CollibraClient
+.. autoclass:: wxdi.odcs_generator.generate_odcs_from_collibra.CollibraClient
    :members:
    :undoc-members:
    :show-inheritance:
 
-.. autoclass:: ODCSGenerator
+ODCSGenerator
+~~~~~~~~~~~~~
+
+.. autoclass:: wxdi.odcs_generator.generate_odcs_from_collibra.ODCSGenerator
    :members:
    :undoc-members:
    :show-inheritance:
 
+.. currentmodule:: wxdi.odcs_generator.generate_odcs_from_informatica
+
 Informatica Integration
 -----------------------
 
-.. currentmodule:: wxdi.odcs_generator.generate_odcs_from_informatica
-
-.. autoclass:: InformaticaClient
-   :members:
-   :undoc-members:
-   :show-inheritance:
+InformaticaClient
+~~~~~~~~~~~~~~~~~
 
-.. autoclass:: ODCSGenerator
+.. autoclass:: wxdi.odcs_generator.generate_odcs_from_informatica.InformaticaClient
    :members:
    :undoc-members:
    :show-inheritance:

src/wxdi/data_product_recommender/__init__.py

@@ -21,4 +21,22 @@
 based on usage patterns, user diversity, and table relationships.
 """
 
+from .recommender import DataProductRecommender
+from .platforms import (
+    SnowflakeQueryParser,
+    DatabricksQueryParser,
+    BigQueryQueryParser,
+    WatsonxDataQueryParser,
+)
+from .base import QueryLogParser
+
+__all__ = [
+    "DataProductRecommender",
+    "SnowflakeQueryParser",
+    "DatabricksQueryParser",
+    "BigQueryQueryParser",
+    "WatsonxDataQueryParser",
+    "QueryLogParser",
+]
+
 __version__ = "0.1.0"

src/wxdi/dph_services/dph_v1.py

@@ -1392,9 +1392,7 @@ def replace_data_product_draft_contract_terms(
                contract.
         :param List[ContractTemplateSLA] sla: (optional) Service Level Agreement
                details.
-        :param List[ContractTemplateSupportAndCommunication]
-               support_and_communication: (optional) Support and communication details for
-               the contract.
+        :param List[ContractTemplateSupportAndCommunication] support_and_communication: (optional) Support and communication details for the contract.
         :param List[ContractTemplateCustomProperty] custom_properties: (optional)
                Custom properties that are not part of the standard contract.
         :param ContractTest contract_test: (optional) Contains the contract test