docs: document read-only input mapping for BigQuery transformations

[romanbracinik]

What

Adds a Bucket Objects for Read-Only Input Mapping section to the BigQuery transformations page, on par with the existing Snowflake section.

• Uses the BigQuery dataset model: in.c-main → dataset in_c_main; <branchId>_in_c_* in dev branches.
• How to reference tables (fully qualified backtick names) and linked buckets (qualify with the source project ID).
• Dev tip: create a workspace with read-only input mappings enabled to discover project/dataset names.
• New subsection on branch read isolation (ships with DMD-1699): a dev-branch workspace reads its own branch + default datasets; other branches are denied; a default-branch workspace reads only default datasets.
• Does not copy the Snowflake "dev branches share the same schema as production" caveat — it is Snowflake-specific and false for BigQuery.
• Fixes the BigQuery link on the mappings page to point at the new anchor.

Verification

• npm run build clean.
• node scripts/audit-phase2.mjs: no new broken links (3 pre-existing, unrelated).

Closes DMD-1739

[linear-code]

DMD-1739

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
connection-docs	Ready	Preview, Comment	Jul 13, 2026 4:53pm

[keboola-pr-reviewer-bot]

Verdict: needs_human (risk 2/5) · profile docs

Escalate — new BigQuery section introduces product-behaviour claims that need product-team confirmation.

Concerns:

• src/content/docs/transformations/bigquery/index.md: New unverifiable product-behaviour claims (dataset naming, alias VIEWs, linked-bucket refs)
• src/content/docs/transformations/bigquery/index.md: Dev-branch read-isolation behaviour documented as shipping with an unreleased ticket

Suggested reviewers: @keboola/docs

[jordanrburger]

Review summary

Verdict: merge-ready pending one release check.

Clean, well-structured — mirrors the existing Snowflake "Bucket Objects for Read-Only Input Mapping" section for BigQuery. Frontmatter/markdown intact, correct location (transformations/bigquery/index.md), and the anchor fix on the mappings page resolves correctly (#bucket-objects-for-read-only-input-mapping).

Before publishing:

• The "Read-Only Input Mapping in Development Branches" subsection documents behavior the PR body says "ships with DMD-1699." Confirm that ticket is actually released at/before merge — otherwise this documents unreleased behavior.

Product-behavior claims (dataset naming in_c_main, alias VIEWs, linked-bucket project-ID qualification, INFORMATION_SCHEMA.SCHEMATA) come from an engineer and mirror the Snowflake section, so they're plausible — a product sign-off is the right gate since they can't be verified from the diff.

Automated review pass (Claude Code), flagged for a human maintainer — not an approval.