Repository navigation
feat(website): changelog change markers, smooth scrolling, sticky banner, header blur and /docs for the current docs - #25
Merged
Conversation
Lightning CSS, Vite 8's CSS minifier, kept only the -webkit-backdrop-filter of the header (written after the unprefixed one), which Chromium ignores. Write the standard property alone and let it add the prefix Safari needs.
Each section of a release (breaking changes, features, fixes, deprecations) gets its color, from its heading, both in the curated notes and in the ones changelogithub writes: the heading, a rule along its list and the bullets. A legend under the filters names the colors.
Links to a section of the page you're on (the table of contents, heading anchors, /page/#section) scroll smoothly; page changes still start at the top at once, and prefers-reduced-motion keeps the jump. A sync$ click handler sets scroll-behavior only for those links, since the router scrolls page changes with the same calls.
…ne under the header The current docs no longer show the "v2 is in beta" banner: the header's badge and the install instructions already say it. The banner on the docs of an older line now sticks with the header, on one line at any width (a shorter text on narrow screens), and the sticky sidebar, table of contents, mobile menu and heading anchors start below both (--docs-top).
The current line's docs move from /docs/v2/… to /docs/…, and an older line keeps /docs/v<n>/… (/docs/v1/…). vercel.json redirects /docs/v2/… to /docs/… for the links already out there. The paths come from CURRENT_VERSION (versions.ts), and website/README.md says what to move when a new major ships.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Instead of colored headings, rules and bullets, each change gets a symbol in place of its bullet, as in qwik-date: ! breaking (amber), + new (blue), ~ fix and − deprecated (gray). The headings stay neutral and the legend uses the same symbols.
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.
Stacked on #24: merge that one first.
Changes
-webkit-backdrop-filter, which Chromium ignores. The CSS now writes the standard property alone, and Lightning CSS adds the prefix Safari needs.data-kind, read from its heading. This works with both the curated notes and changelogithub's.!breaking (amber),+new (blue),~fix and−deprecated (gray)./page/#section).sync$click handler setsscroll-behavioronly for those links. The router scrolls page changes with the same calls, so a global rule would animate those too.prefers-reduced-motionkeeps the jump.--docs-top./docsserves the current docs. The v2 pages move from/docs/v2/…to/docs/…, and an older line keeps/docs/v<n>/…(/docs/v1/…).vercel.jsonredirects/docs/v2/…to/docs/…(308), so existing links keep working.CURRENT_VERSION.website/README.mdexplains what to move when a new major ships.Checks
fmt.checkandlintpass at the root.build.types,lintand the full SSG build pass inwebsite/./docs/, its 7 subpages,/docs/v1/…and the changelog.<Link>navigation to every page, plus the changelog filter, works with no console errors (2 rounds)./docs/toast/and/docs/v1/api/, with the active sidebar link, pager and edit link right on both.scrollY: a TOC click animates, a page change jumps to 0, and withprefers-reduced-motionit jumps.backdrop-filteris back in Chromium, and the built rule has both the prefixed and the standard property.The
/docs/v2/…redirects only exist invercel.json, so this PR's Vercel preview is where to try them. Onpnpm devthose addresses return 404.