# (C) 2026 GoodData Corporation

fix(docs): generate pages for all duplicate-named modules

python_ref_builder used leaf name as the links dict key with an

"if name not in links" guard that skipped page creation for modules

sharing a name (e.g. declarative_model exists under data_source,

workspace, user, and permission). Only the first was generated.

Decouple page creation from the links dedup check so all modules

get their directories and pages, while the links dict still uses

first-wins for type-annotation resolution.

JIRA: trivial
risk: nonprod

Author: hkad98

scripts/docs/python_ref_builder.py

@@ -333,34 +333,34 @@ def _pass1(data_root: dict, dir_root: Path, api_ref_root: str, module_import_pat
                 obj_module_import_path = obj_module_import_path.replace(".functions", "")
 
             if kind == "module":
+                (dir_root / name).mkdir(exist_ok=True)
                 if name not in links:
-                    (dir_root / name).mkdir(exist_ok=True)
                     links[name] = {"path": f"{api_ref_root}/{name}".lower(), "kind": "function"}
-                    pages.append(
-                        _PageSpec(
-                            kind="module",
-                            name=name,
-                            parent_name="",
-                            import_path=obj_module_import_path,
-                            file_path=dir_root / name / "_index.md",
-                            data=obj,
-                        )
+                pages.append(
+                    _PageSpec(
+                        kind="module",
+                        name=name,
+                        parent_name="",
+                        import_path=obj_module_import_path,
+                        file_path=dir_root / name / "_index.md",
+                        data=obj,
                     )
+                )
 
             elif kind == "class":
+                (dir_root / name).mkdir(exist_ok=True)
                 if name not in links:
-                    (dir_root / name).mkdir(exist_ok=True)
                     links[name] = {"path": f"{api_ref_root}/{name}".lower(), "kind": "class"}
-                    pages.append(
-                        _PageSpec(
-                            kind="class",
-                            name=name,
-                            parent_name=module_import_path.split(".")[-1],
-                            import_path=obj_module_import_path,
-                            file_path=dir_root / name / "_index.md",
-                            data=obj,
-                        )
+                pages.append(
+                    _PageSpec(
+                        kind="class",
+                        name=name,
+                        parent_name=module_import_path.split(".")[-1],
+                        import_path=obj_module_import_path,
+                        file_path=dir_root / name / "_index.md",
+                        data=obj,
                     )
+                )
 
             elif name == "functions":
                 for func_name in obj: