LSCSS

Versions

Release history

These numbers track this documentation site, not a separate library on npm. Newest release first. Each card has a short summary; when a release moves or drops how we present LSCSS, the lists under What changed and Removed or retired spell that out so you can see what moved where.

Releases

  1. LSCSS 0.5

    Current

    Site implementation aligned with LSCSS naming: temporary UI state uses `.is_*` with underscores; stable layout variants use BEM-style `--` modifiers on the owning block.

    What changed

    • Primary header mobile menu uses `.is_nav_open` on `.site-header` (state from interaction), with matching script and `site-header` styles.
    • Documentation pagination uses a short `doc-pager` block with contextual children (`.link`, `.body`, `.name`) and modifiers `link--previous` / `link--next`, not `.is_*` classes, matching /apply/modifiers-and-state/.
    • Site chrome moves from BEM `__` chains to LSCSS-style roots and short children: e.g. `hub-card` > `.link` / `.body`, `site-footer` > `.inner` / `.topics`, docs sidebar `disclosure` > `.toc` > `.list`, versions `release` > `.row` / `.changes`, and `site-search` for Pagefind.

  2. LSCSS 0.4

    Archived

    Discovery and technical SEO pass: sitemap and robots, canonical and social meta, richer RSS, structured data for FAQ and breadcrumbs, default share artwork, and cleaner legacy redirects aligned with trailing-slash URLs.

    What changed

    • @astrojs/sitemap builds sitemap-index.xml; public/robots.txt points crawlers at it and allows common documentation and AI crawlers.
    • BaseLayout adds canonical URLs, Open Graph and Twitter Card tags, a default /images/og-default.svg share image (overridable per page), and an RSS autodiscovery link.
    • RSS items now include guid, pubDate, and description; channel declares language.
    • Learn FAQ ships FAQPage JSON-LD matching visible Q&A; docs breadcrumbs add BreadcrumbList JSON-LD with absolute URLs.
    • Footer legal links include RSS feed and sitemap for quick access.
    • Astro trailingSlash: always plus single trailing-slash keys for legacy redirects remove duplicate-route build warnings and match how internal links are written.

    Removed or retired

    • Paired redirect config entries for the same legacy path with and without a trailing slash—replaced by one key per source and site-wide trailing-slash behaviour.

  3. LSCSS 0.3

    Archived

    Retired the old interactive toolbox; flattened routes (/modern-css/, /search/, /versions/) with redirects from /reference/. Rebuilt global styles and tokens to match DESIGN.md. Added accessibility and AI transparency pages, refreshed the footer, tightened primary navigation, and improved the header on small and touch screens. Pagefind search works after a local build, with clearer errors when the index is missing.

    What changed

    • Information architecture: Modern CSS under /modern-css/, search under /search/, this history under /versions/; old /reference/… URLs redirect.
    • Global CSS and design tokens rebuilt against DESIGN.md so the live site matches the agreed visual spec.
    • Primary navigation calls out Modern CSS; footer links to the accessibility statement, AI transparency page, and this version log.
    • Pagefind wired for search after build; clearer messaging when the index is absent in dev.

    Removed or retired

    • The /reference/tools/ set (cascade debugger, specificity tools, container-query visualiser, performance and accessibility demos, browser-support demos, devtools-style inspector, and their assets) as a maintained surface. Apply, Learn, and Writing guides carry that teaching instead.
    • The /reference/ catch-all: modern CSS and versions are top-level routes now; legacy URLs redirect.

  4. LSCSS 0.2

    Archived

    Switched documentation to category-first URLs (Learn, Apply, Teams, Writing, Reference), then realigned navigation, sidebars, breadcrumbs, and internal links.

    What changed

    • Paths follow audience-facing categories instead of opaque folder names.
    • Sidebars, breadcrumbs, and footer nav match the new map; internal links updated in bulk.
    • Starter template lives under Apply; /starter-template redirects.

    Removed or retired

    • Pre-migration URL shapes superseded by redirects (no duplicate pages for the same content).

  5. LSCSS 0.1

    Archived

    First public draft: layers, semantic naming, shallow selectors, modern CSS, migration, tooling, and team-facing comparisons.

    What changed

    • Core framing: layer order and ownership, semantic naming, shallow selectors, utilities as exceptions, tokens, visible hacks, and incremental change.
    • Modern CSS (selectors, nesting, container queries, logical properties, view transitions) documented alongside the methodology.
    • Early migration, tooling, comparisons, and anti-pattern material for adoption and audits.

About versioning

The workspace package.json version is kept in step with the site for convenience. Methodology detail can move between releases; the live pages are always the source of truth for intent.

When a release changes or retires methodology, navigation, or teaching surface in a way readers would notice, add short bullets to the changed and removed arrays for that version in src/data/versions.ts. Facts over adjectives; point to the replacement URL in the bullet when there is one.