Skip to content

docs: reorder landing and clarify service evaluation paths - #253

Merged
intech merged 1 commit into
mainfrom
docs/landing-reader-path
Nov 4, 2026
Merged

intech merged 1 commit into
mainfrom
docs/landing-reader-path

Conversation

@intech

@intech intech commented Nov 4, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Reorder the landing to hero, ecosystem, code, deployment, goals, lifecycle and package cards. Keep the approved hero, artwork, players, card layout and resource footer.
  • Explain what Connectum adds over ConnectRPC, how handlers and optional modules fit together, and when ConnectRPC alone is sufficient. Make catalog/routing prerequisites and infrastructure boundaries explicit.
  • Link each next step to its owning guide. Correct adapter anchors, the catalog executable and stale example metadata; validate module-guide fragments.

Verification

  • 146 source tests, including all 480 Builder/CLI combinations; seven strict Vue configurations; scoped Biome with zero warnings/errors.
  • Homepage, Quickstart, descriptors and OpenAPI regenerate without tracked drift. Production build and validation pass: 686 pages, 15 modules, 7,413 fragment links, none broken.
  • Browser checks cover actual section order at 320–1440px, both themes, 24 click destinations, keyboard focus, no-JS fallbacks and every landing/header/footer/module-metadata URL and fragment.
  • Accepted-demo and navigation suites pass, including both homepage players, Builder ZIP downloads and compatibility routes. Desktop/mobile screenshots inspected.
  • All package README links pass against the built site and external HTTP: 15 packages, 16 READMEs, 90 distinct links per file, zero unresolved, for both release and current source trees.
  • Released 1.3.0 framework build/types/lint and tests pass (8,755 pass; two existing skips, one existing TODO). No framework code or dependency changes. Packaging, cross-runtime and performance matrices and API regeneration are outside this documentation-only change.

The existing Vite 5 development-tool advisory exception is unchanged; dependency manifests and lockfiles are untouched.

Publication

An existing Pages deployment lock currently blocks publication of main: run41904152652. The old deployment was explicitly cancelled, but Pages still reports it as in progress. Hosting settings are unchanged. A successful merge must be followed by a successful deployment and public-site verification.

@intech intech added the type:docs Documentation: guides, README, JSDoc label Nov 4, 2026
@coderabbitai

coderabbitai Bot commented Nov 4, 2026

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 25 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: ed0ea65a-077a-4a2c-98e3-06bc67388ba0
Commits

Reviewing files that changed from the base of the PR and between 94bca45 and 33e7409.

Files selected for processing: 6
  • .vitepress/data/modules.ts
  • .vitepress/homepage/deployment-markup.mjs
  • .vitepress/theme/components/HomePage.vue
  • scripts/check-landing-browser.mjs
  • scripts/docs-validate.mjs
  • tests/homepage/landing.test.mjs
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@intech
intech merged commit 211b4b3 into main Nov 4, 2026
8 checks passed
@intech
intech deleted the docs/landing-reader-path branch November 4, 2026 20:46
@intech

intech commented Nov 4, 2026

Copy link
Copy Markdown
Contributor Author

Published at https://connectum.dev/en/ from merge commit 211b4b3741b459abcccae704953a1774583fa13f.

Pages deployment succeeded. Fresh public-site verification passed:

  • Requested section order at 320–1440px in both themes, 24 real click destinations, keyboard paths and no-JS fallbacks.
  • All 81 landing/header/footer/module-metadata URLs and fragments.
  • Both homepage players, approved hero, validation/interceptor/OpenAPI demos and Builder ZIP downloads.
  • Canonical navigation, compatibility URLs/fragments and the Get started menu change from docs: remove Builder from Get started sidebar #252.
  • All README links for 15 framework packages, including nested READMEs and final public-site destinations: 16 READMEs, 90 links per source audit, zero unresolved.

The earlier Pages lock cleared on this automatic deployment. No hosting settings were changed. Temporary preview servers and the manual browser session have been stopped.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type:docs Documentation: guides, README, JSDoc

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant