Release prep: bump to v0.2 + refresh docs (#807) - #838
Merged
Conversation
#807) Doc sweep for the v0.2 release line: - Cut the `Unreleased` block in release-notes.md into a dated `0.2` section. Add a `Highlights` summary covering the Oats-sweep themes (ADR-0070..0104), the legacy-spelling removals with their migration diagnostics, native-interop end-to-end, the Go-flavored opt-in import, and tooling polish (LSP async-shaped completions, nil quick fixes, null->nil did-you-mean). - Update the version-base paragraph to point at `0.2`. - Add diagnostics-page sections for previously-undocumented v0.2 IDs: GS0285-GS0287 (top-level statements), GS0288 (field var/let), GS0289-GS0292 (deinit), GS0293-GS0295 (labeled break/continue), and GS0365 (variadic slot in anonymous function-type clause must be a slice). Extend the existing GS0363/GS0364 section to cover ADR-0102. - Tutorials: drop the stale "this is the v0.1 design" comment in control-flow.md. Refs #807, #706
Snapshot the live docs as the new `version-0.2` set (created with `npm run docusaurus -- docs:version 0.2`) and retire the `version-0.1` snapshot. Update versions.json so the docusaurus version dropdown lists only `0.2` and `Next`. The 0.1 URL space is no longer served. Verified `npm ci && npm run build` succeeds with no broken links and no warnings. Refs #807, #706
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Release prep for the v0.2 line ("Oats" sweep, parent epic #706). This PR bumps the
nbgvversion base, refreshes the docs to match the v0.2 ground truth, and rotates the Docusaurus versioned-docs snapshot from0.1to0.2. The orchestrator will tagv0.2.<patch>on main once this merges.What's in this PR
Three commits, one logical change each:
chore—version.jsonbumped from0.1to0.2(patch component remains auto-derived from commit height by nbgv).docs— release notes rewritten with a dated0.2section, diagnostics catalogue extended (GS0285–GS0297 added; GS0365 added; ADR-0102 covered alongside ADR-0101), a stale "v0.1 design" comment removed from a tutorial.docs(website)— freshversion-0.2snapshot generated vianpm run docusaurus -- docs:version 0.2; oldversion-0.1/snapshot, sidebar, andversions.jsonentry retired.v0.2 themes covered in the release notes
Language additions
while/do…while+ labeled break/continue (ADR-0070),if let/guard let(ADR-0071),??=(ADR-0072),a?[i](ADR-0073), arrow lambdas (ADR-0074),(T) -> Rfunction-type clause (ADR-0075), lambda binding inference (ADR-0076), Kotlin/Swift-style type-declaration grammar (ADR-0078), if-as-expression finished (ADR-0064, #711), smart-cast extensions (ADR-0069 addendum), discriminated-union enum payloads (#725),default(T)(ADR-0100), variadic...Tparams at every declaration site (ADR-0101 + ADR-0102 + ADR-0103),class/struct/new()constraints (ADR-0097), default-interface methods (ADR-0085/0089/0090/0091), reified generics (ADR-0087),Gsharp.Extensions.Optional/Sequences(ADR-0084), friendly numeric aliases (ADR-0098),map[K,V](ADR-0104).Removals
typekeyword for type declarations (ADR-0078),recordkeyword (ADR-0078),:=short declaration (ADR-0077,GS0305),name = valuenamed-arg form (ADR-0080,GS0315),func(T) Rlegacy function-type syntax (ADR-0075,GS0303), Go-flavoredmap[K]V(ADR-0104,GS0366).Native interop end-to-end
@DllImport(ADR-0086),@LibraryImport(ADR-0092), struct marshalling (ADR-0093),ref/out/in(ADR-0094), function pointers (ADR-0095),@MarshalAs(ADR-0096).Concurrency
Go-flavored
go/chan/selectand built-inslen/cap/append/make/deletegated behindimport Gsharp.Extensions.Go(ADR-0082, ADR-0083).Tooling
LSP completion polish for async-shaped types (#713), nil-related quick fixes from
textDocument/codeAction(ADR-0099),null→nil"did you mean" diagnostic (ADR-0081,GS0273).Verification
dotnet build GSharp.sln -nologo -clp:NoSummary— succeeded (warnings only; baselineMSB3026retry +GS9100reference closure warning on the Extensions project).dotnet test GSharp.sln --no-restore --nologo— all green: 32 + 104 + 296 + 266 + 3262 + 1319 = 5279 passed, 0 failed, 1 skipped (existingRegenerateBaseline).dotnet tool restore—dotnet-ilverifyrestored.cd website && npm ci && npm run build— clean build, no broken links, no warnings.grep '"version"' version.json→"version": "0.2",website/versioned_docs/version-0.1/is gone,version-0.2/exists;versions.jsonlists only"0.2".Follow-up (orchestrator)
After merge, the orchestrator will:
nbgv get-versionon the mergedmainto compute the patch component.git tag -a v0.2.<patch>and push the tag; the publish job in.github/workflows/build.ymlhandles the release artefacts.Closes #807.
Parent: #706 (will be closed after the v0.2 tag is pushed).