feat: umbrella landing + docs covering toolkit and Studio#4
Merged
Conversation
Make the site the front door for the whole ecosystem. The landing now presents both products with a comparison table and an interop note; the docs add a Studio overview and a download/install page; the docs nav lists every page grouped by product; and the stale v0.1 marketing and scenarios doc are refreshed to the current toolkit surface. - Shared SiteHeader across landing + docs - Two-product landing: hero CTAs, product cards, comparison table, interop note - New docs/studio (overview) + docs/studio/install (macOS one-liner, Linux, source) - Fixed docs nav (was missing five pages), grouped Toolkit / Studio - Refreshed scenarios doc from 5 scenarios / 3 rules to 15 scenarios / 16 rules - Reworked landing spec + new studio-docs spec Counts are source-verified against @ocpp-debugkit/toolkit@0.3.1 (16 failure codes, 15 scenarios); the toolkit prose was inconsistent.
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
1 participant
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.
Summary
Make the site the umbrella front door for the ecosystem — the landing and docs
now cover both
toolkitandstudio, and the stale v0.1 marketing isrefreshed to the current surface.
Changes
Landing (
src/app/page.tsx)/inspector) andDownload Studio (→
/docs/studio/install).comparison table, and an interop note (a Studio capture opens in the web
inspector; links the conformance contract).
Test / Automate.
Nav + layout
SiteHeader(Home / Inspector / Docs / Studio / GitHub), used by thelanding and docs.
Studio docs
docs/studio— overview (capabilities, native vs browser, conformance contract).docs/studio/install— macOS one-liner, Linux tarball, build-from-source, Releases.Content refresh
docs/scenarioscorrected from the v0.1 figures (5 scenarios / 3 rules) to thecurrent 15 scenarios / 16 rules, with real per-scenario descriptions.
Tests
landing.spec.tsfor the new hero, both-product coverage, and footer.studio-docs.spec.tsasserting both Studio pages render and the installcommand is present.
Content accuracy
Counts were verified against the installed
@ocpp-debugkit/toolkit@0.3.1— 16distinct failure codes and
scenarios.length === 15. The toolkit's own prose wasinconsistent (README 10 / CURRENT_STATE 15 / Studio 16). Studio install details
and release links come from the
studiorepo (latest v0.5.2).Verification
pnpm build— 19 routes (adds/docs/studio,/docs/studio/install).pnpm typecheck— clean.pnpm lint— 0 errors (1 pre-existing inspector warning, unchanged).pnpm test:e2e— 19 passed (reworked landing + new Studio specs;inspector/replay unchanged).
Closes #3