Skip to content

Merge master into v1: the docs website - #1996

Merged
TwitchBronBron merged 4 commits into
v1from
docs-website-for-v1
Nov 20, 2026
Merged

TwitchBronBron merged 4 commits into
v1from
docs-website-for-v1

Conversation

@TwitchBronBron

Copy link
Copy Markdown
Member

Brings the docs website (#1991) into v1, so pushes to v1 redeploy the site, and v1's docs build with their own tooling instead of master's fallback.

  • Merges master into v1. v1's docs move into getting-started/, language-features/ and tooling/, and the v1-only type pages get their own Type System sidebar category.
  • README and Getting Started rewritten for v1: /v1/ doc links, brighterscript@next, outDir and compilerOptions, --noEmit, and no zip or deploy (which v1's bsc doesn't do).
  • Transpiled examples regenerated with v1's compiler, all shown in the collapsible toggle. Fixes the Exceptions name-collision example, which didn't actually collide.
  • Fixes site.mjs building another version from a branch that only exists as origin/<branch>: it now fetches that exact ref instead of relying on a plain local clone.
  • Narrows the docs workflow's branch filter to v[0-9]+, so branches like v1-foo don't trigger a redeploy.

Both fixes also need to go to master, since master's copy runs the deploys. Replaces #1995, whose v1- branch name tripped v1's branch protection.

Verified with npm run build-docs (v0 from master, v1 from this branch), transpile-doc-examples --check and npm run lint.

🤖 Generated with Claude Code

TwitchBronBron and others added 4 commits November 20, 2026 16:47
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Moves v1's docs into the new getting-started/language-features/tooling layout, with a Type System sidebar category for the v1-only type pages, adapts the README and Getting Started pages to v1 (outDir, compilerOptions, @next, no zip/deploy), and regenerates the transpiled examples with v1's compiler. Also fetches each other version's exact branch ref when building the site, since a plain local clone doesn't include origin/* commits.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ke v1-docs-website

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… built

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@TwitchBronBron
TwitchBronBron enabled auto-merge (squash) November 20, 2026 19:20
@TwitchBronBron
TwitchBronBron enabled auto-merge (squash) November 20, 2026 19:20
@TwitchBronBron
TwitchBronBron merged commit 57d2b4f into v1 Nov 20, 2026
11 checks passed
@TwitchBronBron
TwitchBronBron deleted the docs-website-for-v1 branch November 20, 2026 19:29
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.

1 participant