docs: fix broken links in README.md for firestore and major libraries

Updates the shared README.md template to:
- Fix Authentication and Troubleshooting links globally.
- Add link to the Java-specific authentication guide.
- Handle monorepo pathing for samples.

Updates test goldens to match template changes.

Updates `.repo-metadata.json` and regenerates `README.md` (or manually fixes them)
for the following major/handwritten libraries to resolve broken Javadocs,
Authentication, Troubleshooting, and Samples links:
- java-bigtable
- java-pubsub
- java-bigquery
- java-bigquerystorage
- java-logging
- java-logging-logback
- java-storage
- java-storage-nio
- java-spanner
- java-spanner-jdbc
- java-firestore
- java-datastore

Fixes: #13530

Author: lqiu96

java-bigquery/.repo-metadata.json

@@ -2,7 +2,7 @@
   "api_shortname": "bigquery",
   "name_pretty": "Cloud BigQuery",
   "product_documentation": "https://cloud.google.com/bigquery",
-  "client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-bigquery/latest/history",
+  "client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-bigquery/latest/overview",
   "api_description": "is a fully managed, NoOps, low cost data analytics service.\nData can be streamed into BigQuery at millions of rows per second to enable real-time analysis.\nWith BigQuery you can easily deploy Petabyte-scale Databases.",
   "issue_tracker": "https://issuetracker.google.com/savedsearches/559654",
   "release_level": "stable",

java-bigquery/README.md

@@ -3,7 +3,7 @@
   "name_pretty": "BigQuery Storage",
   "product_documentation": "https://cloud.google.com/bigquery/docs/reference/storage/",
   "api_description": "is an API for reading data stored in BigQuery. This API provides direct, high-throughput read access to existing BigQuery tables, supports parallel access with automatic liquid sharding, and allows fine-grained control over what data is returned.",
-  "client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-bigquerystorage/latest/history",
+  "client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-bigquerystorage/latest/overview",
   "release_level": "stable",
   "transport": "grpc",
   "language": "java",
@@ -16,4 +16,4 @@
   "codeowner_team": "@googleapis/bigquery-team",
   "issue_tracker": "https://issuetracker.google.com/savedsearches/559654",
   "recommended_package": "com.google.cloud.bigquery.storage.v1"
-}
+}

java-bigquerystorage/.repo-metadata.json

@@ -3,7 +3,7 @@
   "name_pretty": "Cloud Bigtable",
   "product_documentation": "https://cloud.google.com/bigtable",
   "api_description": "API for reading and writing the contents of Bigtables associated with a cloud project.",
-  "client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-bigtable/latest/history",
+  "client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-bigtable/latest/overview",
   "release_level": "stable",
   "transport": "grpc",
   "language": "java",
@@ -18,4 +18,4 @@
   "issue_tracker": "https://issuetracker.google.com/savedsearches/559777",
   "extra_versioned_modules": "google-cloud-bigtable-emulator,google-cloud-bigtable-emulator-core",
   "recommended_package": "com.google.cloud.bigtable"
-}
+}

java-bigquerystorage/README.md

@@ -3,7 +3,7 @@
   "name_pretty": "Cloud Datastore",
   "product_documentation": "https://cloud.google.com/datastore",
   "api_description": "is a fully managed, schemaless database for\\nstoring non-relational data. Cloud Datastore automatically scales with\\nyour users and supports ACID transactions, high availability of reads and\\nwrites, strong consistency for reads and ancestor queries, and eventual\\nconsistency for all other queries.",
-  "client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-datastore/latest/history",
+  "client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-datastore/latest/overview",
   "release_level": "stable",
   "transport": "both",
   "language": "java",

java-bigtable/.repo-metadata.json

@@ -3,7 +3,7 @@
   "name_pretty": "Cloud Firestore",
   "product_documentation": "https://cloud.google.com/firestore",
   "api_description": "is a fully-managed NoSQL document database for mobile, web, and server development from Firebase and Google Cloud Platform.  It's backed by a multi-region replicated database that ensures once data is committed, it's durable even in the face of unexpected disasters. Not only that, but despite being a distributed database, it's also strongly consistent and offers seamless integration with other Firebase and Google Cloud Platform products, including Google Cloud Functions.",
-  "client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-firestore/latest/history",
+  "client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-firestore/latest/overview",
   "release_level": "stable",
   "transport": "grpc",
   "language": "java",

java-bigtable/README.md

@@ -67,7 +67,7 @@ libraryDependencies += "com.google.cloud" % "google-cloud-firestore" % "3.43.1"
 
 ## Authentication
 
-See the [Authentication][authentication] section in the base directory's README.
+See the [Authentication][authentication] guide and the [Java-specific Authentication Guide][java-authentication] for more information.
 
 ## Authorization
 
@@ -102,22 +102,20 @@ use this Cloud Firestore Client Library.
 
 ## Samples
 
-Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-java/tree/main/samples) directory.
-
+Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-java/tree/main/java-firestore/samples) directory.
 | Sample                      | Source Code                       | Try it |
 | --------------------------- | --------------------------------- | ------ |
-| Pipeline Snippets | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/preview-snippets/src/main/java/com/example/firestore/PipelineSnippets.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/preview-snippets/src/main/java/com/example/firestore/PipelineSnippets.java) |
-| Quickstart | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/firestore/Quickstart.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/firestore/Quickstart.java) |
-| Example Firestore Beam Read | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/firestore/beam/ExampleFirestoreBeamRead.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/firestore/beam/ExampleFirestoreBeamRead.java) |
-| Example Firestore Beam Write | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/firestore/beam/ExampleFirestoreBeamWrite.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/firestore/beam/ExampleFirestoreBeamWrite.java) |
-| Listen Data Snippets | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/firestore/snippets/ListenDataSnippets.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/firestore/snippets/ListenDataSnippets.java) |
-| Manage Data Snippets | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/firestore/snippets/ManageDataSnippets.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/firestore/snippets/ManageDataSnippets.java) |
-| Multiple Range Inequality Filters Snippets | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/firestore/snippets/MultipleRangeInequalityFiltersSnippets.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/firestore/snippets/MultipleRangeInequalityFiltersSnippets.java) |
-| Query Data Snippets | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/firestore/snippets/QueryDataSnippets.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/firestore/snippets/QueryDataSnippets.java) |
-| References | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/firestore/snippets/References.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/firestore/snippets/References.java) |
-| Retrieve Data Snippets | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/firestore/snippets/RetrieveDataSnippets.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/firestore/snippets/RetrieveDataSnippets.java) |
-| City | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/firestore/snippets/model/City.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/firestore/snippets/model/City.java) |
-
+| Pipeline Snippets | [source code](https://github.com/googleapis/google-cloud-java/blob/main/java-firestore/samples/preview-snippets/src/main/java/com/example/firestore/PipelineSnippets.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=java-firestore/samples/preview-snippets/src/main/java/com/example/firestore/PipelineSnippets.java) |
+| Quickstart | [source code](https://github.com/googleapis/google-cloud-java/blob/main/java-firestore/samples/snippets/src/main/java/com/example/firestore/Quickstart.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=java-firestore/samples/snippets/src/main/java/com/example/firestore/Quickstart.java) |
+| Example Firestore Beam Read | [source code](https://github.com/googleapis/google-cloud-java/blob/main/java-firestore/samples/snippets/src/main/java/com/example/firestore/beam/ExampleFirestoreBeamRead.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=java-firestore/samples/snippets/src/main/java/com/example/firestore/beam/ExampleFirestoreBeamRead.java) |
+| Example Firestore Beam Write | [source code](https://github.com/googleapis/google-cloud-java/blob/main/java-firestore/samples/snippets/src/main/java/com/example/firestore/beam/ExampleFirestoreBeamWrite.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=java-firestore/samples/snippets/src/main/java/com/example/firestore/beam/ExampleFirestoreBeamWrite.java) |
+| Listen Data Snippets | [source code](https://github.com/googleapis/google-cloud-java/blob/main/java-firestore/samples/snippets/src/main/java/com/example/firestore/snippets/ListenDataSnippets.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=java-firestore/samples/snippets/src/main/java/com/example/firestore/snippets/ListenDataSnippets.java) |
+| Manage Data Snippets | [source code](https://github.com/googleapis/google-cloud-java/blob/main/java-firestore/samples/snippets/src/main/java/com/example/firestore/snippets/ManageDataSnippets.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=java-firestore/samples/snippets/src/main/java/com/example/firestore/snippets/ManageDataSnippets.java) |
+| Multiple Range Inequality Filters Snippets | [source code](https://github.com/googleapis/google-cloud-java/blob/main/java-firestore/samples/snippets/src/main/java/com/example/firestore/snippets/MultipleRangeInequalityFiltersSnippets.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=java-firestore/samples/snippets/src/main/java/com/example/firestore/snippets/MultipleRangeInequalityFiltersSnippets.java) |
+| Query Data Snippets | [source code](https://github.com/googleapis/google-cloud-java/blob/main/java-firestore/samples/snippets/src/main/java/com/example/firestore/snippets/QueryDataSnippets.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=java-firestore/samples/snippets/src/main/java/com/example/firestore/snippets/QueryDataSnippets.java) |
+| References | [source code](https://github.com/googleapis/google-cloud-java/blob/main/java-firestore/samples/snippets/src/main/java/com/example/firestore/snippets/References.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=java-firestore/samples/snippets/src/main/java/com/example/firestore/snippets/References.java) |
+| Retrieve Data Snippets | [source code](https://github.com/googleapis/google-cloud-java/blob/main/java-firestore/samples/snippets/src/main/java/com/example/firestore/snippets/RetrieveDataSnippets.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=java-firestore/samples/snippets/src/main/java/com/example/firestore/snippets/RetrieveDataSnippets.java) |
+| City | [source code](https://github.com/googleapis/google-cloud-java/blob/main/java-firestore/samples/snippets/src/main/java/com/example/firestore/snippets/model/City.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=java-firestore/samples/snippets/src/main/java/com/example/firestore/snippets/model/City.java) |
 
 
 ## Troubleshooting
@@ -198,18 +196,19 @@ Apache 2.0 - See [LICENSE][license] for more information.
 Java is a registered trademark of Oracle and/or its affiliates.
 
 [product-docs]: https://cloud.google.com/firestore
-[javadocs]: https://cloud.google.com/java/docs/reference/google-cloud-firestore/latest/history
+[javadocs]: https://cloud.google.com/java/docs/reference/google-cloud-firestore/latest/overview
 [stability-image]: https://img.shields.io/badge/stability-stable-green
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-firestore.svg
 [maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-firestore/3.43.1
-[authentication]: https://github.com/googleapis/google-cloud-java#authentication
+[authentication]: https://cloud.google.com/docs/authentication/
+[java-authentication]: https://cloud.google.com/java/getting-started/getting-started-with-google-auth-library
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles
 [iam-policy]: https://cloud.google.com/iam/docs/overview#cloud-iam-policy
 [developer-console]: https://console.developers.google.com/
 [create-project]: https://cloud.google.com/resource-manager/docs/creating-managing-projects
 [cloud-cli]: https://cloud.google.com/cli
-[troubleshooting]: https://github.com/googleapis/google-cloud-java/blob/main/TROUBLESHOOTING.md
+[troubleshooting]: https://cloud.google.com/java/docs/troubleshooting
 [contributing]: https://github.com/googleapis/google-cloud-java/blob/main/CONTRIBUTING.md
 [code-of-conduct]: https://github.com/googleapis/google-cloud-java/blob/main/CODE_OF_CONDUCT.md#contributor-code-of-conduct
 [license]: https://github.com/googleapis/google-cloud-java/blob/main/LICENSE