Skip to content

Update docs for Server 0.7.0 and clients 0.2.0 - #74

Merged
davidalucas merged 2 commits into
mainfrom
73-current-release-documentation
Sep 21, 2026
Merged

davidalucas merged 2 commits into
mainfrom
73-current-release-documentation

Conversation

@davidalucas

@davidalucas davidalucas commented Sep 20, 2026 •

Copy link
Copy Markdown
Contributor

Readers could install current Briosa packages and land in references for older releases or a catalog claiming SA 2024 had not shipped. This publishes Server 0.7.0 and client 0.2.0 references for both exact SA targets and reconciles the catalog and product guides with those releases.

  • Preserve existing SA 2026 routes; add grouped SA 2024 references under sa-2024.1.0508.5/ in each API family. Retain Server 0.5.1 and client 0.1.0 at explicit historical routes, with historical API cross-links.
  • Reconcile 1,027 SA 2026 and 996 SA 2024 MP operations against tagged protobuf and handwritten client declarations. Correct exact-target inputs, defaults, values, and JavaScript function-versus-client-method call shapes. Document discovery, behavioral compatibility, and installation selection.
  • Promote only the 996 verified SA 2024 catalog entries to Current; retain SA 2026-only differences and validation qualifications. Update every target-specific API destination and distinguish limited licensed smoke evidence from release availability.
  • Update release, prerequisite, deployment, migration, protocol-artifact, and contributor guidance. Qualify search/page metadata by product version and target, preserve grouped navigation, and polish the official DocSearch button and results modal with matching light/dark colors, clearer shortcut keys, visible keyboard focus, and compact mobile controls.

The large diff includes maintained working references and their Docusaurus snapshots. Protocol and operation semantics remain owned by the released product repositories; no catalog schema or generation framework is introduced.

Validation:

  • Node 24.19.0: npm ci and npm run check pass, including a final build with the repository's public Algolia configuration. All 14 search/SEO/release tests pass.
  • Both target inventories agree with released protobuf and implementation registrations, and every operation has a destination in all four API families.
  • Discovery examples compile against both published NuGet 0.2.0 packages; TypeScript examples type-check against both npm packages; JavaScript and Python discovery examples execute without starting SA.
  • Edge browser checks pass for historical version switching, exact-target links, grouped sidebars, the 996-row SA 2024 Current filter, mobile layout, and Discord menu access. Search refinements were reviewed on localhost; live Algolia results, Ctrl+K, arrow selection, Escape/focus return, reduced motion, and nine navbar widths from 320 to 1440 pixels pass browser checks.
  • git diff --cached --check passes.

No licensed SA execution suite was run for this documentation change. Existing v1 validation gates remain open. After merge/deployment, verify the live routes and refresh the Algolia crawler with the updated configuration; local builds do not publish a search index.

Closes #73. Related: #8, #12, #13; their broader acceptance criteria remain separate.

@davidalucas
davidalucas merged commit 2e852f2 into main Sep 21, 2026
1 check passed
@davidalucas
davidalucas deleted the 73-current-release-documentation branch September 21, 2026 01:13
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.

Reconcile documentation with Server 0.7.0 and clients 0.2.0

1 participant