fix: correct FirestoreAdminClient source link in documentation (#2304)

jinseopkim0 · cloud-java-bot · web-flow · commit 1f66dcaa3e93 · 2026-02-04T14:45:09.000-05:00
* fix: correct FirestoreAdminClient source link in documentation

The FirestoreAdminClient source code resides in the `google-cloud-firestore-admin`
directory, which differs from the artifact ID (`google-cloud-firestore`). This
mismatch causes the generated GitHub source links in the documentation to be broken.

This change adds `library_path_overrides` to `.repo-metadata.json` to explicitly
map `FirestoreAdminClient` to the correct source directory.

Fixes: b/442875200

* chore: generate libraries at Wed Jan 28 18:54:55 UTC 2026

---------

Co-authored-by: cloud-java-bot &lt;cloud-java-bot@google.com&gt;
diff --git a/.repo-metadata.json b/.repo-metadata.json
@@ -16,5 +16,8 @@
   "codeowner_team": "@googleapis/api-firestore @googleapis/firestore-dpe",
   "excluded_poms": "google-cloud-firestore,google-cloud-firestore-bom",
   "issue_tracker": "https://issuetracker.google.com/savedsearches/5337669",
-  "recommended_package": "com.google.cloud.firestore"
-}
+  "recommended_package": "com.google.cloud.firestore",
+  "library_path_overrides": {
+    "FirestoreAdminClient": "google-cloud-firestore-admin"
+  }
+}
diff --git a/owlbot.py b/owlbot.py
@@ -14,6 +14,7 @@
 
 """This script is used to synthesize generated parts of this library."""
 
+import json
 import synthtool as s
 import synthtool.gcp as gcp
 import synthtool.languages.java as java
@@ -97,3 +98,24 @@
     '.github/workflows/samples.yaml',
     'renovate.json'
 ])
+
+# Fix for b/442875200: Inject library_path_overrides for FirestoreAdminClient
+# This ensures the doclet links to the correct source directory (google-cloud-firestore-admin)
+# instead of the default artifactId (google-cloud-firestore).
+metadata_path = ".repo-metadata.json"
+try:
+    with open(metadata_path, "r") as f:
+        metadata = json.load(f)
+
+    # Add the override map if it doesn't exist or update it
+    if "library_path_overrides" not in metadata:
+        metadata["library_path_overrides"] = {}
+
+    metadata["library_path_overrides"]["FirestoreAdminClient"] = "google-cloud-firestore-admin"
+
+    # Write the updated metadata back to the file
+    with open(metadata_path, "w") as f:
+        json.dump(metadata, f, indent=2)
+        f.write("\n")
+except Exception as e:
+    print(f"Failed to update .repo-metadata.json: {e}")
