From 6cb400e7d15de93a8fe48498f5e3a5c7b657f8df Mon Sep 17 00:00:00 2001
From: Jan Kadlec <jan.kadlec@gooddata.com>
Date: Tue, 9 Sep 2025 14:26:13 +0200
Subject: [PATCH] docs: add missing method

Add missing documentation for `scan_pdm_and_generate_logical_model` method.

JIRA: TRIVIAL
risk: low
---
 .../en/latest/data/data-source/_index.md      |  1 +
 .../scan_pdm_and_generate_logical_model.md    | 51 +++++++++++++++++++
 2 files changed, 52 insertions(+)
 create mode 100644 docs/content/en/latest/data/data-source/scan_pdm_and_generate_logical_model.md

diff --git a/docs/content/en/latest/data/data-source/_index.md b/docs/content/en/latest/data/data-source/_index.md
index a9066e47d..9a8829d31 100644
--- a/docs/content/en/latest/data/data-source/_index.md
+++ b/docs/content/en/latest/data/data-source/_index.md
@@ -33,6 +33,7 @@ See [Connect Data](https://www.gooddata.com/docs/cloud/connect-data/) to learn h
 * [generate_logical_model](./generate_logical_model/)
 * [register_upload_notification](./register_upload_notification/)
 * [scan_data_source](./scan_data_source/)
+* [scan_pdm_and_generate_logical_model](./scan_pdm_and_generate_logical_model/)
 * [scan_schemata](./scan_schemata/)
 * [scan_sql](./scan_sql/)
 
diff --git a/docs/content/en/latest/data/data-source/scan_pdm_and_generate_logical_model.md b/docs/content/en/latest/data/data-source/scan_pdm_and_generate_logical_model.md
new file mode 100644
index 000000000..731be55ab
--- /dev/null
+++ b/docs/content/en/latest/data/data-source/scan_pdm_and_generate_logical_model.md
@@ -0,0 +1,51 @@
+---
+title: "scan_pdm_and_generate_logical_model"
+linkTitle: "scan_pdm_and_generate_logical_model"
+weight: 190
+superheading: "catalog_data_source."
+---
+
+``scan_pdm_and_generate_logical_model(data_source_id: str, generate_ldm_request: Optional[CatalogGenerateLdmRequest] = None, scan_request: CatalogScanModelRequest = CatalogScanModelRequest(), report_warnings: bool = False) -> tuple[CatalogDeclarativeModel, CatalogScanResultPdm]``
+
+Scan data source and use returned PDM to generate logical data model. If generate_ldm_request
+contains PDM already, PDM tables received from the scan are appended without deduplication.
+
+{{% parameters-block  title="Parameters"%}}
+
+{{< parameter p_name="data_source_id" p_type="string" >}}
+Data Source identification string. e.g. "demo"
+{{< /parameter >}}
+
+{{< parameter p_name="generate_ldm_request" p_type="Optional[CatalogGenerateLdmRequest]" >}}
+LDM options. Defaults to CatalogGenerateLdmRequest(separator="__", wdf_prefix="wdf")
+{{< /parameter >}}
+
+{{< parameter p_name="scan_request" p_type="Optional[CatalogScanModelRequest]" >}}
+Options for the Scan Request. Defaults to CatalogScanModelRequest().
+{{< /parameter >}}
+
+{{< parameter p_name="report_warnings" p_type="bool" >}}
+Switch to turn on warnings. Defaults to False.
+{{< /parameter >}}
+
+{{% /parameters-block %}}
+
+{{% parameters-block title="Returns"%}}
+
+{{< parameter p_type="CatalogDeclarativeModel" >}}
+Object Containing declarative Logical Data Model.
+{{< /parameter >}}
+
+{{< parameter p_type="CatalogScanResultPdm" >}}
+An instance of CatalogScanResultPdm.
+Containing pdm itself and a list of warnings that occurred during scanning.
+{{< /parameter >}}
+
+{{% /parameters-block %}}
+
+## Example
+
+```python
+# Scan and generate logical model
+ldm, pdm = sdk.catalog_data_source.scan_pdm_and_generate_logical_model(data_source_id="demo-test-ds")
+```