fix: Update old subdomain URLs to new path-based domains by JoeKarlsson · Pull Request #22319 · cloudquery/cloudquery

JoeKarlsson · 2026-03-19T19:15:44Z

Summary

Migrates all docs.cloudquery.io, hub.cloudquery.io, and cli-docs.cloudquery.io subdomain URLs to the new path-based structure under www.cloudquery.io
Updates 18 files across READMEs, CONTRIBUTING, plugin docs, issue templates, scaffold templates, and CLI source code
Skips CHANGELOG entries as they are historical records

URL mapping:

Old	New
`docs.cloudquery.io/docs/*`	`www.cloudquery.io/docs/*`
`hub.cloudquery.io/*`	`www.cloudquery.io/hub/*`
`cli-docs.cloudquery.io/docs/*`	`www.cloudquery.io/docs/*`

Test plan

Verify all updated URLs resolve correctly (old subdomains already 301 redirect to new paths)
Check CLI help text renders correct URLs (cloudquery sync --help)
Confirm go test ./cli/cmd/... passes with updated test expectations

🤖 Generated with Claude Code

Migrate all references from deprecated subdomains to the new path-based URL structure: - docs.cloudquery.io/docs/* -> www.cloudquery.io/docs/* - hub.cloudquery.io/* -> www.cloudquery.io/hub/* - cli-docs.cloudquery.io/docs/* -> www.cloudquery.io/docs/* Updates READMEs, CONTRIBUTING, plugin docs, issue templates, scaffold templates, and CLI source code across 18 files. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

erezrokah · 2026-03-20T09:21:38Z

@copilot check for 404 links in this PR changes

Copilot · 2026-03-20T09:21:46Z

@erezrokah I've opened a new pull request, #22321, to work on those changes. Once the pull request is ready, I'll request review from you.

Copilot

Pull request overview

This PR migrates references to legacy CloudQuery documentation and hub subdomains (docs.cloudquery.io, hub.cloudquery.io, cli-docs.cloudquery.io) to the new path-based URL structure under www.cloudquery.io, keeping READMEs, templates, and CLI help text aligned with the website move.

Changes:

Updated documentation and hub links across repository READMEs, plugin docs, contributing docs, and scaffold templates.
Updated CLI user-facing strings to reference the new docs/hub URLs and adjusted generated reference docs accordingly.
Updated CLI test expectations to match the new hub URL in error messages.

Reviewed changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
scaffold/sourcetpl/templates/source/README.md.tpl	Updates scaffolded plugin README links to new docs/hub paths.
scaffold/sourcetpl/templates/source/.github/workflows/release.yaml.tpl	Updates scaffolded release workflow comment link to new docs path.
README.md	Updates quickstart/hub links in the main project README.
plugins/source/typeform/README.md	Updates Typeform plugin README user guide link.
plugins/source/typeform/docs/overview.md	Updates hub/docs links inside Typeform overview documentation.
plugins/source/square/README.md	Updates Square plugin README user guide link.
plugins/source/square/docs/overview.md	Updates hub/docs links inside Square overview documentation.
plugins/source/bitbucket/docs/overview.md	Updates hub/docs links inside Bitbucket overview documentation.
plugins/source/airtable/docs/overview.md	Updates hub/docs links inside Airtable overview documentation.
plugins/README.md	Updates CLI docs link in plugins umbrella README.
plugins/destination/snowflake/README.md	Updates Snowflake destination README user guide link.
CONTRIBUTING.md	Updates contributor guide links that point to legacy docs subdomain.
cli/docs/reference/cloudquery_sync.md	Updates generated reference docs text for the `--shard` flag URL.
cli/cmd/sync.go	Updates `--shard` flag help text URL to new docs path.
cli/cmd/init.go	Updates plugin hub URL formatter to new `www.cloudquery.io/hub/...` structure.
cli/cmd/infer_test.go	Updates test expectation for hub URL prefix in error message.
.github/ISSUE_TEMPLATE/new_source_integration.yml	Updates issue template link to new docs path.
.github/ISSUE_TEMPLATE/new_destination_integration.yml	Updates issue template link to new docs path.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

cli/cmd/init.go

erezrokah · 2026-03-20T09:34:42Z

@copilot open a new pull request to apply changes based on the comments in this thread

Copilot · 2026-03-20T09:34:49Z

@erezrokah I've opened a new pull request, #22323, to work on those changes. Once the pull request is ready, I'll request review from you.

Follow-up to the subdomain→path URL migration: the previous PR changed domains but left several paths pointing to non-existent pages. Also updates the remaining `hub.cloudquery.io` reference missed in the original pass, and regenerates CLI reference docs. ## 404 fixes - **`cli/cmd/sync.go`** (`--shard` flag help text): `docs/advanced-topics/running-cloudquery-in-parallel` → `docs/cli/managing-cloudquery/running-in-parallel` - **`plugins/source/{airtable,bitbucket,typeform}/docs/overview.md`**: `docs/advanced-topics/using-cloud-query-docker-registry-plugins-inside-a-containerized-environment` → `…-integrations-…` (the `plugins` variant 404s; `integrations` resolves — consistent with `square/docs/overview.md`) ## Missed URL - **`cli/cmd/install.go`** error hint: `hub.cloudquery.io` → `www.cloudquery.io/hub` ## Codegen - Re-ran `make gen-docs` in `cli/` — `cli/docs/reference/cloudquery_sync.md` updated to reflect the corrected `--shard` URL  --- 💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more [Copilot coding agent tips](https://gh.io/copilot-coding-agent-tips) in the docs. --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: erezrokah <26760571+erezrokah@users.noreply.github.com>

erezrokah · 2026-03-23T17:48:53Z

@copilot fix the fail tests

Copilot · 2026-03-23T17:49:02Z

@erezrokah I've opened a new pull request, #22340, to work on those changes. Once the pull request is ready, I'll request review from you.

The previous URL migration PR incorrectly updated a test assertion in `cli/cmd/infer_test.go` to expect `www.cloudquery.io/hub/plugins/...`, but the error message is generated by the external `plugin-pb-go` dependency which still produces `hub.cloudquery.io/plugins/...`, causing `TestInferRegistry` to fail in CI. - **`cli/cmd/infer_test.go`**: Reverted the `wantErrContains` assertion back to `https://hub.cloudquery.io/plugins/...` to match the actual error emitted by `plugin-pb-go`  --- ⌨️ Start Copilot coding agent tasks without leaving your editor — available in [VS Code](https://gh.io/cca-vs-code-docs), [Visual Studio](https://gh.io/cca-visual-studio-docs), [JetBrains IDEs](https://gh.io/cca-jetbrains-docs) and [Eclipse](https://gh.io/cca-eclipse-docs). --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: erezrokah <26760571+erezrokah@users.noreply.github.com>

erezrokah · 2026-03-23T17:58:02Z

The tests were failing because one URL has to be updated in https://github.com/cloudquery/plugin-pb-go, see #22340.

I'll do the relevant fixes in the upstream dependency

Copilot · 2026-03-23T18:05:44Z

@erezrokah I've opened a new pull request, #22342, to work on those changes. Once the pull request is ready, I'll request review from you.

JoeKarlsson requested a review from a team as a code owner March 19, 2026 19:15

JoeKarlsson requested a review from disq March 19, 2026 19:15

cq-bot added area/cli area/plugin/source/bitbucket area/plugin/source/airtable area/plugin/source/square area/plugin/source/typeform area/plugin/destination/snowflake area/scaffold labels Mar 19, 2026

dcelasun approved these changes Mar 19, 2026

View reviewed changes

JoeKarlsson self-assigned this Mar 19, 2026

JoeKarlsson added the automerge Automatically merge once required checks pass label Mar 19, 2026

Merge branch 'main' into fix/update-readme-domains

52381c5

erezrokah removed the automerge Automatically merge once required checks pass label Mar 20, 2026

Copilot AI mentioned this pull request Mar 20, 2026

fix: Update old subdomain URLs to new path-based domains #22321

Closed

erezrokah requested a review from Copilot March 20, 2026 09:21

Copilot started reviewing on behalf of erezrokah March 20, 2026 09:22 View session

Copilot AI reviewed Mar 20, 2026

View reviewed changes

cli/cmd/init.go Show resolved Hide resolved

Copilot AI mentioned this pull request Mar 20, 2026

fix: Fix 404 links and run CLI codegen for URL migration PR #22323

Merged

erezrokah added the automerge Automatically merge once required checks pass label Mar 20, 2026

erezrokah added 2 commits March 20, 2026 12:53

Merge branch 'main' into fix/update-readme-domains

8f8e2b1

Merge branch 'main' into fix/update-readme-domains

a484abf

Copilot AI mentioned this pull request Mar 23, 2026

fix: Update old subdomain URLs to new path-based domains #22340

Merged

Merge branch 'main' into fix/update-readme-domains

8dd4733

erezrokah mentioned this pull request Mar 23, 2026

fix: Update Hub URLs from hub.cloudquery.io to www.cloudquery.io/hub cloudquery/plugin-pb-go#621

Open

erezrokah removed the automerge Automatically merge once required checks pass label Mar 23, 2026

Copilot AI mentioned this pull request Mar 23, 2026

cli: Update hub.cloudquery.io URL to www.cloudquery.io/hub in install hint #22342

Closed

erezrokah added the automerge Automatically merge once required checks pass label Mar 23, 2026

kodiakhq bot merged commit a7cec25 into main Mar 23, 2026
21 checks passed

kodiakhq bot deleted the fix/update-readme-domains branch March 23, 2026 18:23

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

fix: Update old subdomain URLs to new path-based domains#22319

fix: Update old subdomain URLs to new path-based domains#22319
kodiakhq[bot] merged 7 commits intomainfrom
fix/update-readme-domains

JoeKarlsson commented Mar 19, 2026

Uh oh!

erezrokah commented Mar 20, 2026

Uh oh!

Copilot AI commented Mar 20, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

erezrokah commented Mar 20, 2026

Uh oh!

Copilot AI commented Mar 20, 2026

Uh oh!

erezrokah commented Mar 23, 2026

Uh oh!

Copilot AI commented Mar 23, 2026

Uh oh!

erezrokah commented Mar 23, 2026

Uh oh!

Copilot AI commented Mar 23, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Conversation

JoeKarlsson commented Mar 19, 2026

Summary

URL mapping:

Test plan

Uh oh!

erezrokah commented Mar 20, 2026

Uh oh!

Copilot AI commented Mar 20, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

erezrokah commented Mar 20, 2026

Uh oh!

Copilot AI commented Mar 20, 2026

Uh oh!

erezrokah commented Mar 23, 2026

Uh oh!

Copilot AI commented Mar 23, 2026

Uh oh!

erezrokah commented Mar 23, 2026

Uh oh!

Copilot AI commented Mar 23, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants