Skip to content

Mirror the README into the Pages index and refresh the Sass reference - #327

Merged
smelfungus merged 1 commit into
masterfrom
docs/pages-mirror-and-sass-link
Sep 2, 2026
Merged

smelfungus merged 1 commit into
masterfrom
docs/pages-mirror-and-sass-link

Conversation

@smelfungus

Copy link
Copy Markdown
Member

docs/index.md was a hand-written condensed copy of the README, and it had drifted: no gallery, no custom thumb, no conversions or architecture sections, and it still described the library before the wasm target and the screenshot goldens existed. Keeping two hand-maintained descriptions of the same library is what produced that gap, so the page is now derived from the README, with only two deliberate differences — image paths lose the docs/ prefix because index.md is served from inside that directory, and the H1 keeps the longer form, which reads better as a page title than the bare repository name.

The Sass citation pointed at the OddBird color spaces proposal, which is now archived and says so at the top of the page. It points at the shipped documentation instead, which states the property being cited outright: a color can be converted into and back out of a narrower space without losing information.

docs/index.md was a hand-written condensed copy of the README, and it had drifted: no gallery, no custom thumb, no conversions or architecture sections, and it still described the library before the wasm target and the screenshot goldens existed. Keeping two hand-maintained descriptions of the same library is what produced that gap, so the page is now derived from the README, with only two deliberate differences — image paths lose the docs/ prefix because index.md is served from inside that directory, and the H1 keeps the longer form, which reads better as a page title than the bare repository name.

The Sass citation pointed at the OddBird color spaces proposal, which is now archived and says so at the top of the page. It points at the shipped documentation instead, which states the property being cited outright: a color can be converted into and back out of a narrower space without losing information.
@smelfungus smelfungus self-assigned this Sep 2, 2026
@smelfungus
smelfungus merged commit 1eeec83 into master Sep 2, 2026
2 checks passed
@smelfungus
smelfungus deleted the docs/pages-mirror-and-sass-link branch September 2, 2026 02:41
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.

1 participant