Skip to content

docs(bigquery): update malformed and legacy documentation URLs - #15123

Merged
lqiu96 merged 2 commits into
googleapis:mainfrom
lqiu96:docs/bq-0b-fix-legacy-urls
Nov 21, 2026
Merged

lqiu96 merged 2 commits into
googleapis:mainfrom
lqiu96:docs/bq-0b-fix-legacy-urls

Conversation

@lqiu96

@lqiu96 lqiu96 commented Nov 20, 2026 •

Copy link
Copy Markdown
Member

Updates 157 malformed, legacy, and broken-anchor documentation URLs across 33 files in java-bigquery (Javadoc and comment-only, no behavioral changes).

Summary of changes

  • Fix malformed hhttps:// URL in ExternalTableDefinition.java.
  • Replace pre-/docs/ cloud.google.com/bigquery/... links (which no longer resolve to canonical documentation pages or drop section anchors) with canonical https://docs.cloud.google.com/bigquery/... destinations and exact section anchors (for example, quotas#query_jobs, sessions#create-session, adding-labels#adding_dataset_labels, and biglake-intro#metadata_caching_for_performance).
  • Update legacy /docs/reference/v2/... URLs and broken camelCase anchors to /docs/reference/rest/v2/... with live REST schema, field, and enum anchors (including pointing JobInfo and BigQuery.JobField to /rest/v2/Job, LoadConfiguration.setFormatOptions to Job#JobConfigurationLoad.FIELDS.source_format, ExternalTableDefinition and CopyJobConfiguration to exact .FIELDS.* anchors, RoutineInfo to #routinetype and #datagovernancetype, and BigQuery.TableMetadataView's link label to TableMetadataView).
  • Fix wrong-topic links for TableDefinition.Type.MATERIALIZED_VIEW (materialized-views-intro), ModelTableDefinition, and TableDefinition.Type.MODEL (bqml-introduction).
  • Replace the legacy developers.google.com Discovery Javadoc link in BigQueryDryRunResult.java with the canonical REST Job#JobStatistics2.FIELDS.undeclared_query_parameters anchor.
  • Update broken cloud.google.com/bigquery/pricing#storage and #long-term-storage anchors to #storage-pricing.
  • Migrate remaining cloud.google.com/bigquery/docs/... and cloud.google.com/iam/docs/... links to docs.cloud.google.com.

Note: Four lines currently touched by open PRs #15117 and #15118 are skipped here to avoid merge conflicts (DatasetInfo.java:41 will be updated in a follow-up after #15118 merges). Historical GitHub issue comments are preserved.

Verification

  • Every unique target URL (71/71) verified live with HTTP 200, 0 redirects, and matching HTML id= anchors where fragments are present
  • mvn -pl java-bigquery/google-cloud-bigquery com.spotify.fmt:fmt-maven-plugin:check -Dlint checkstyle:check@checkstyle test-compile (0 Checkstyle violations)
  • javadoc -Xdoclint:syntax,html,reference on all 33 modified files (0 warnings/errors)

@lqiu96
lqiu96 requested review from a team as code owners November 20, 2026 23:00

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates numerous documentation URLs in the Javadoc comments across the google-cloud-bigquery library. The links have been updated from the legacy cloud.google.com domain to the newer docs.cloud.google.com domain to ensure they point to the correct and current documentation pages. There are no review comments to address, and I have no additional feedback to provide.

@lqiu96
lqiu96 enabled auto-merge (squash) November 21, 2026 00:03
@lqiu96
lqiu96 merged commit e628795 into googleapis:main Nov 21, 2026
199 of 200 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants