Changelog
This changelog records notable changes to the D Lang Supplemental documentation portal itself, including playbook additions, configuration changes, and global reorganizations.
Facto-stack v0.2.40 (search dock layout)
-
Bump
@antora-supplemental/facto-stackto v0.2.40 (search bar stays on screen above the footer).
Lockfile check before pnpm antora
-
pnpm antorainstalls when the lockfile is newer than node_modules (git tag bumps). It does not move the facto-stack pin by itself; pull the repo first.
Facto-stack v0.2.39 (desktop disk-search dialog)
-
Bump
@antora-supplemental/facto-stackto v0.2.39 (Windows disk search uses a dialog instead of the Y/n banner).
Facto-stack v0.2.38 (banner wrap)
-
Bump
@antora-supplemental/facto-stackto v0.2.38 (disk-search banner wraps inside the frame).
Facto-stack v0.2.37 (local content banner)
-
Bump
@antora-supplemental/facto-stackto v0.2.37 (disk-search banner prints once, as ASCII, on Windows).
Local content via facto-stack
-
Removed
antora-playbook-local.ymlandbuild:local. Pin@antora-supplemental/facto-stackv0.2.34 (registersantora-local-content-sources). Hub repo adds.antora-source-id; content repos should add markers for hive clone discovery.
Provider dedupe
-
Drop the
overridesentry forlink-validator; facto-stack v0.2.21+ pins link-validator v0.2.2 itself.package.jsondeclaresfacto-stack(plus tooling), nothing else from the pack.
Facto-stack v0.2.22 (linkinator v0.1.10)
-
Bump
@antora-supplemental/facto-stackto v0.2.22 — Wayback chip stays opaque on hover/focus (no transparent--adt-accent-softon the floating control).
2026-10-17
Hub GitHub topics (direct deps only).
Repository topics
-
Retag playbook repo:
facto-stackonly (provider rule; removedvalentus-themeand transitive pack-member topics). Policy: Hub GitHub topicsunchecked.
Facto-stack pack pins (linkinator, page-edit).
Facto-stack v0.2.18 (linkinator v0.1.7)
-
Bump
@antora-supplemental/facto-stackto v0.2.18 —@antora-supplemental/linkinatorv0.1.7: idle Wayback overlay uses zero layout footprint so link rows stay aligned. -
Pack includes
@antora-supplemental/page-editv0.2.5 (View | Edit when tag-pinned sources supply forge blob URLs insrc.editUrl).
Facto-stack v0.2.16 (linkinator v0.1.6)
-
Bump
@antora-supplemental/facto-stackto v0.2.16 —@antora-supplemental/linkinatorv0.1.6: link-only hover tint, floating ⧉ Wayback control above the anchor (not inline in prose or whole list items).
Hub link-cache invalidation and link-validator v0.2.2 override.
Hub link-cache invalidation
-
Deploy listens for
repository_dispatchtypelink-cache-invalidate; maps payloadsources/urls/refto link-validator env and checkout. How-to: Notify the docs hub of link changes. Reusable dispatch:dlang-supplemental/.github; exemplar callerdlang-supplemental/asciidoctor-d. -
pnpm override pins
@antora-supplemental/link-validator#v0.2.2through Facto stack (surgical invalidation env).
Facto-stack compose pack pin.
2026-10-16
Portal hub updates.
Hub index nav label Overview
-
Hub Overview uses
:navtitle: Overviewand the first nav entry Overview; the page H1 is D Lang Supplemental Portal (Dev-Centr-style split: component Home, portal name in content, overview label in the sidebar).
Hub component home (avoid /docs/docs/)
-
AGENTS.mdlinks the canonical Dev-Centr write-up Hub home componentunchecked and skillhub-home-overview. -
Hub Antora component
nameishome(wasdocs), matching Dev-Centr and antora-supplemental hub conventions. Meta-docs stay in this repo’sdocs/content tree; the published URL segment is/home/under the GitHub Pages site base (…/docs/home/), not…/docs/docs/. -
Post-build step mirrors hub HTML under
…/docs/docs/with client redirects to the matching…/docs/home/page so old bookmarks keep working. -
site.start_pageishome::index.adoc; hubdocs/antora.ymlkeepsstart_page: ROOT:index.adoc. -
Keyword listings still use
lib/page-context-keywords-host.json thehomecomponent at/docs/keywords/(page-context-keyword-baseunchanged).
Portal as site and component home
-
site.start_pagepoints at Overview (wasasciidoctor-d:ROOT:index.adoc), so the site root redirect, header title link, and breadcrumb home chip land on the hub instead of a product component.
SoftNav breadcrumbs and page TOC
-
Detail links append Changelog in the breadcrumb (
… / Changelog / Detail title) instead of replacing that crumb with the detail title. -
Right-rail page TOC rebuilds after a soft navigation. The previous heading selector threw, so the rail stayed on the page you left.
-
@antora-supplemental/facto-stackv0.2.4 pulls@antora-supplemental/soft-nav-page-tocv0.1.6 (script URL,:hide-page:meta, and the parent crumb on a hard load).See Detailed changelog.
Changelog heading format
-
Index and detail pages use
== YYYY-MM-DD(date only) and===topic lines with short descriptions;:toclevels: 3lists topics in the page TOC. -
Changelog detail pages declare
:hide-page:and:navtree-parent: changelog.adocfor nav-drift audits, breadcrumb trails, and SoftNav nav-tree injection.See Detailed changelog.
Linkinator hover bar and chrome exclusions
-
@antora-supplemental/linkinatorv0.1.2+ shows Wayback controls in a hover bar on article links only (not header, footer, or page-context metadata). -
Extension display name is Linkinator (
v0.1.3registry metadata; npm package id unchanged).See Detailed changelog.
Learning about D media page
-
Curated Learning about D hub page (maintainer list via PR/issue); includes Wookash Podcast interview with Lewis Nicolle on why D.
See Detailed changelog.
Facto stack and site search
-
Playbook requires
@antora-supplemental/facto-stackonce (compose Antora extension); Lunr,@antora-supplemental/antora-search-chat, page-context, nav typology, link tooling, and related members register from the pack so the footer lists depth-1 imports.See Detailed changelog.
SoftNav TOC and in-page hash jumps
-
Fixed hub
soft-nav.jstreating sidebar TOC hash links as cross-page soft loads when folder URLs used a trailing slash (/changelog/sectionvs/changelog/). Same-pageclicks now scroll the article; soft fetch applies#after swaps when needed.
SoftNav page TOC after detail links
-
@antora-supplemental/facto-stackv0.2.3 registers@antora-supplemental/soft-nav-page-tocso the right-rail page TOC rebuilds when SoftNav swaps to changelog-details and other in-component pages. Upstream proposal: SoftNav page TOC and nav-hidden pagesunchecked.
SoftNav scroll, TOC, and nav-hidden children
-
Hub
soft-nav.jskeeps the left nav tree stable on soft loads (swapNavoff), scrolls to top on cross-page navigation, rebuilds the right-rail TOC, soft-navigates same-component nav links, patches breadcrumbs for:hide-page:entries, and injects them under their:navtree-parent:(Changelog → detail) on hard and soft loads.
Nav tree parent registry
-
navtree-registry.jsonand a;; navtree-parent-association:line innav.adocdeclare parent links for:hide-page:entries when path heuristics are not enough (for example tgc design 0.1.0 under Proposals).
Left nav text filter (site-nav-tree)
-
Removed hub-only filter assets (supplemental
nav-menu,nav-tree-filterCSS/JS). A sticky label filter belongs on@antora-supplemental/site-nav-treewithfilter: truewhen that extension is registered (this hub still uses facto-stack single-component sidebar per page). -
@antora-supplemental/facto-stackv0.2.5 ships site-nav-tree withfilter: trueby default when you enable packsiteNavTree(unchanged for this single-component hub until site-nav-tree is opted in).
2026-10-06
Diagrams rebuilt with Mermaid CLI 12
-
Regenerated all six
tgcMermaid diagrams with@mermaid-js/mermaid-cli12.0.0 (Mermaid 12, Puppeteer 25). The diagram config pins Mermaid 12 to the previous dagre layout, classic look, and 200px label wrapping, so the diagrams keep their existing appearance; the middle dot in the shared-heap comparison now renders correctly. -
The site build and diagram toolchain now run on Node.js 24 (Mermaid CLI 12 requires Node.js 22.13 or later).
2026-09-10
Dark-mode diagram box fills
-
Regenerated all six
tgcMermaid diagrams with@dev-centr/themed-svg0.2.3 so nodefill/strokeinline!importantvalues become theme CSS variables (fixes light boxes with dark-mode text). -
Progressive delivery CDN and package pins move from 0.1.1 to 0.2.3 (
@dev-centr/mermaid-svg-css-vars0.1.3).See Detailed changelog.
2026-09-08
Mermaid sources and Themed SVG for tgc diagrams
-
Migrated all six canonical
tgcdiagrams to Mermaid sources with explicit Themed SVG manifests, adaptive image artifacts, host artifacts, sanitized progressive delivery, and warning-free cross-platform Mermaid CLI invocation. The prior fixed drawings remain available for comparison.
2026-09-07
tgc hardening and timeline theming.
tgc 0.2.3 audit hardening
-
Hardened the
tgcprototype as 0.2.3 after concurrency and API-contract audits.See Detailed changelog.
tgc 0.2.2 lookup and correctness
-
Updated the
tgcdesign for 0.2.2 with layered block lookup, safer fixpoint marking, corrected append metadata, and remote-free coverage.See Detailed changelog.
tgc timeline theming
-
Remade the stop-the-world timeline in the
tgcarticle with separated thread labels and light/dark theme-aware SVG colors.See Detailed changelog.
2026-09-01
tgc design through 0.2.0 demo.
tgc 0.1.x prototype and canonical design
-
Reframed
tgcas a 0.1.x prototype; added canonical design notes with SemVer plan (0.1.0 private heaps, 0.1.1 region scaffold, 0.2.0 working regions).See Detailed changelog.
tgc demo and 0.2.0 design notes
-
Shipped tgc demo with test/benchmark instructions; design notes updated for 0.2.0 (same day, after the reframe).
See Detailed changelog.
2026-08-17
avalonia-d in the hub
-
Registered avalonia-d in the Antora playbooks and portal component list.
See Detailed changelog.
avalonia-d launch posts
-
Published Avalonia bindings published for D and Hosting Avalonia from D.
See Detailed changelog.
2026-08-15
Proposals index and tgc figures
-
Added Proposals as a tagged index (the portal lists it; the page loads
:page-tags: proposal). -
Added diagrams and desktop/console mockups to the
tgcdesign article, and dated the upstream news to the GitHub opened time ofdlang/dmd#23514unchecked (2 August 2026, 23:02 UTC). -
Cross-linked the org-site essay Isolating heaps as threads isolate dataunchecked.
See Detailed changelog.
Tagged proposal catalog
-
Added a Proposals section on the portal home page that loads articles tagged
proposalfrompage-catalog.json. -
Tagged Thread-local garbage collection (
tgc) for D as a proposal.See Detailed changelog.
2026-08-03
tgc articles and SymGC context
-
Updated the
tgcblog and news articles to acknowledge SymGCunchecked / DConf “We Need a New GC” work and how it relates to pause-isolation goals.See Detailed changelog.
2026-08-02
Blog, news, and tgc launch articles
-
Added dedicated Blog and News sections (separate from this changelog).
-
Published Thread-local garbage collection (
tgc) for D and the upstream PR announcement.See Detailed changelog.
2026-07-31
Publishing D packages from the CLI
-
Added Publishing D packages from the CLI, a news-style guide on
dub-publish, registry owner automation, and the upstreamdub publishunchecked proposal.See Detailed changelog.
2026-07-24
Org logo and Valentus theme
-
Added the org D+ mark (
supplemental-ui/img/logo.svg, D-lang red#B03931) and wired it into the Valentus header viaui.supplemental_filesandsite.keys.header_logo. -
Switched the Antora UI bundle from the retired
antora-dark-themeURL (now dark-mode-only Default UI) to valentus-themeuncheckedv1(ui-bundle.zip).See Detailed changelog.
opentui-d in the hub
-
Registered opentui-d in the Antora playbooks and portal component list.
2026-03-22
Flutter Skia and Impeller guide
-
Added Flutter rendering: Skia and Impeller, a guide covering Skia vs Impeller, transitional “Skia + Impeller” architecture, embedding Impeller from D, and layered decoupling for desktop tooling.
-
Linked the guide from the portal page and from the ROOT module navigation.
2026-03-14
GraphRAG indexer in documentation playbooks
-
Configured the new
graphrag-indexerAntora source in the global playbooks and initialized the portal changelog. -
See Detailed changelog.
2026-03-07
Split local and online playbooks
-
Created a local-development specific playbook mapped to sibling repositories.
-
See Detailed changelog.
2026-03-05
Portal genesis and CI
-
Bootstrapped D Lang Supplemental documentation portal with centralized CI/CD processing and GitHub Pages deployments.
-
See Detailed changelog.