Merge branch 'main' into PR #2227 to update

Author: lqiu96

.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"
+  }
+}

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}")