Skip to content

Refine tmux navigation and runnable homepage examples - #102

Merged
tony merged 52 commits into
mainfrom
feat-tmux-documentation-context
Oct 5, 2026
Merged

tony merged 52 commits into
mainfrom
feat-tmux-documentation-context

Conversation

@tony

@tony tony commented Oct 4, 2026 •

Copy link
Copy Markdown
Contributor

Shared tmux guides now have their own documentation context beneath /en/tmux/, with matching navigation, metadata, translations, prompt links, and permanent redirects from their former paths. Versioned command pages link to available shared guides.

The homepage launcher chooses a language and solution and previews languages on hover. Error handling and Cleanup controls select independently verified complete programs; URL parameters and local storage retain those choices across language changes. Task selection, clearing, rerolling, and copy behavior follow the same controls without unnecessary page navigation.

The responsive header keeps full language names while hiding secondary labels as space narrows. Solution-picker rows reserve space for a border visible on hover or keyboard focus. Language tabs and their code panel share one clean edge, and theme controls preserve the reading position. The prerelease notice aligns with the homepage content.

Validation:

  • All 52 displayed program variants retain native execution receipts and source/setup hashes. Browser checks verify their displayed and copied bytes, language and task controls, preference precedence, history, and no-JavaScript fallback.
  • Independent layout checks cover both themes and narrow widths. The theme-control fix reproduces the original scroll jump and passes in Chromium and Firefox; WebKit remains unverified because of local proxy and SVG access-control failures.
  • The final outer loop passes in 39.69 seconds with source tests, lint, type checks, and a fresh browser sample. Focused output checks pass for installer interactions, code tabs, tmux destinations, and prose row anchors. Three negative controls reject the former prompt paths, skipped widget import, and extra language count.
  • Independent review accepts the final six-file publication-audit repair. Hosted publication CI now passes at the reviewed revision, including the fresh-source browser matrix, assembly, output tests, and preview publication. Its explicitly skipped checks retain their recorded limitations; preview success does not establish live publication across all ports.

The tmux manual/C-source-reference changes and the C# documentation rename follow in their own dependent PRs.

tony added 30 commits October 4, 2026 12:36
General guides and tmux manual pages need the same navigation context as
language documentation. Add a Just tmux destination and hub using the
existing pickers, actual guide inventory and version-specific commands.

Use the official transparent logomark with its license and source pin.
Credit Nicholas Marriott and tmux contributors first in the notices and
identify the hub as independently maintained libtmux documentation.

Keep enhanced and no-JavaScript picker panels within the usable viewport,
including classic scrollbar gutters on narrow screens.
why: The creator's public profile gives his full name, not a verified
nickname preference.

what:
- Keep the tmux acknowledgement consistent with the contributor notice
why: A single action button consumed a separate row on small displays.

what:
- Let breadcrumbs wrap within their column beside the action controls
- Verify the narrow Examples toolbar in both color themes
why: The dismissal control took a separate row and squeezed the message
on narrow displays.

what:
- Show an X beside the badge below 480px with the same accessible name
- Keep the sentence full width and use the shared horizontal inset
- Verify keyboard dismissal, stored state and both color themes
why: Version, locale and navigation controls crowded narrow viewports.

what:
- Put secondary controls in a reversible cog view within the same bar
- Preserve keyboard focus through drawers, picker closure and resizing
- Shorten tmux labels and reduce the smallest header and menu insets
- Keep direct controls available without JavaScript

validation: 80 builder browser cases and independent compact UI review
pass. Astro check reports no errors or warnings. The required outer run
exceeded its fixed 60-second budget; publication remains unverified.
why: Just tmux opens a page directly rather than selecting a language.

what:
- Align a decorative arrow at the trailing edge of the tmux menu link
- Preserve the current-page checkmark and existing menu artwork
- Verify both home and documentation links navigate to the tmux hub
why: Identify the selected language with a local upstream SVG.

what:
- Copy the SVG unchanged and record its SHA-256 and retrieval details
- Keep the existing libtmux artwork in menu options

Provenance: https://www.python.org/community/logos/
Source: https://s3.dualstack.us-east-2.amazonaws.com/pythondotorg-assets/media/files/python-logo-only.svg
Retrieved: 2026-10-04T14:52:41+00:00

Copyright: Python Software Foundation owns the Python trademarks. The
supplied SVG does not contain a separate artwork copyright notice or
year.
License: PSF logo and trademark usage terms
Terms: https://www.python.org/psf/trademarks/
The PSF permits the unaltered two-snakes logo to identify Python.
Preserve the supplied artwork and do not imply endorsement.

Validation: SVG XML parsed; no active or external image content. The
local asset SHA-256 matches the downloaded bytes.
why: Identify the selected language with a local upstream SVG.

what:
- Copy the SVG unchanged and record its SHA-256 and retrieval details
- Keep the existing libtmux artwork in menu options

Provenance: https://www.ruby-lang.org/en/about/logo/
Source: https://www.ruby-lang.org/images/header-ruby-logo.svg
Retrieved: 2026-10-04T14:52:41+00:00

Copyright: Copyright © 2006, Yukihiro Matsumoto.
License: CC-BY-SA-2.5
Terms: https://creativecommons.org/licenses/by-sa/2.5/
Terms: https://www.ruby-lang.org/en/about/logo/
Credit Yukihiro Matsumoto and link the license. This separate, unchanged
artwork retains its license; it does not relicense the surrounding site.

Validation: SVG XML parsed; no active or external image content. The
local asset SHA-256 matches the downloaded bytes.
why: Identify the selected language with a local upstream SVG.

what:
- Copy the SVG unchanged and record its SHA-256 and retrieval details
- Keep the existing libtmux artwork in menu options

Provenance: https://www.lua.org/images/
Source: https://github.com/raw/devicons/devicon/7330accdbc47e2dc0c19789a48533c4a3c50fe58/icons/lua/lua-original.svg
Upstream revision: 7330accdbc47e2dc0c19789a48533c4a3c50fe58
Retrieved: 2026-10-04T14:52:41+00:00

Copyright: Lua logo: Copyright © 1998 Lua.org. Graphic design by
Alexandre Nakonechnyj. Devicon collection: Copyright (c) 2015 konpa.
License: MIT for the Devicon copy; Lua logo permission also applies
Terms: https://github.com/devicons/devicon/blob/7330accdbc47e2dc0c19789a48533c4a3c50fe58/LICENSE
Terms: https://www.lua.org/images/
The collection license does not replace Lua logo terms. Credit the
origin, preserve proportions, and link Lua.org. Only the orbiting text
may be adapted under the logo permission.

Validation: SVG XML parsed; no active or external image content. The
local asset SHA-256 matches the downloaded bytes.
why: Identify the selected language with a local upstream SVG.

what:
- Copy the SVG unchanged and record its SHA-256 and retrieval details
- Keep the existing libtmux artwork in menu options

Provenance: https://www.typescriptlang.org/branding/
Source: https://www.typescriptlang.org/branding/ts-logo-128.svg
Retrieved: 2026-10-04T14:52:41+00:00

Copyright: Microsoft and contributors retain their rights. Microsoft
owns the TypeScript brand; the supplied SVG contains no separate artwork
copyright notice or year.
License: TypeScript branding terms
Terms: https://www.typescriptlang.org/branding/
Terms: https://github.com/microsoft/TypeScript-Website#legal-notices
Use the official blue mark to identify TypeScript. Preserve its shape;
do not incorporate it into the libtmux logo or imply endorsement. The
website repository licenses do not grant Microsoft logo or trademark
rights.

Validation: SVG XML parsed; no active or external image content. The
local asset SHA-256 matches the downloaded bytes.
why: Identify the selected language with a local upstream SVG.

what:
- Copy the SVG unchanged and record its SHA-256 and retrieval details
- Keep the existing libtmux artwork in menu options

Provenance: https://rust-lang.org/
Source: https://rust-lang.org/static/images/favicon.svg
Retrieved: 2026-10-04T14:52:41+00:00

Copyright: The Rust Foundation owns the Rust and Cargo logos. The
supplied SVG contains no copyright year.
License: CC-BY-4.0 with Rust trademark policy
Terms: https://creativecommons.org/licenses/by/4.0/
Terms: https://rustfoundation.org/policy/rust-trademark-policy/
Credit the Rust Foundation, link CC BY 4.0, and disclose modifications.
The unmodified mark identifies Rust in documentation; it does not
indicate endorsement. The upstream SVG includes its own dark color-
scheme rendering.

Validation: SVG XML parsed; no active or external image content. The
local asset SHA-256 matches the downloaded bytes.
why: Identify the selected language with a local upstream SVG.

what:
- Copy the SVG unchanged and record its SHA-256 and retrieval details
- Keep the existing libtmux artwork in menu options

Provenance: https://go.dev/blog/gopher
Source: https://go.dev/images/favicon-gopher.svg
Retrieved: 2026-10-04T14:52:41+00:00

Copyright: Go gopher artwork by Renee French. The source does not
specify a copyright year for this SVG.
License: CC-BY-4.0
Terms: https://creativecommons.org/licenses/by/4.0/
Terms: https://go.dev/blog/gopher
Credit Renee French, link the license, and indicate changes. This is the
favicon form supplied by the official Go website.

Validation: SVG XML parsed; no active or external image content. The
local asset SHA-256 matches the downloaded bytes.
why: Identify the selected language with a local upstream SVG.

what:
- Copy the SVG unchanged and record its SHA-256 and retrieval details
- Keep the existing libtmux artwork in menu options

Provenance: https://github.com/isocpp/logos
Source: https://github.com/raw/isocpp/logos/64ef037049f87ac74875dbe72695e59118b52186/cpp_logo.svg
Upstream revision: 64ef037049f87ac74875dbe72695e59118b52186
Retrieved: 2026-10-04T14:52:41+00:00

Copyright: Artwork created by Jeremy Kratz and licensed by the Standard
C++ Foundation. The SVG and repository README do not supply a separate
artwork copyright notice or year.
License: Standard C++ Foundation logo permission
Terms: https://isocpp.org/home/terms-of-use
Use the unaltered logo for material related to standardized C++, without
implying affiliation or endorsement. Keep it separate from the libtmux
identity.

Validation: SVG XML parsed; no active or external image content. The
local asset SHA-256 matches the downloaded bytes.
why: Identify the selected language with a local upstream SVG.

what:
- Copy the SVG unchanged and record its SHA-256 and retrieval details
- Keep the existing libtmux artwork in menu options

Provenance: https://www.swift.org/
Source: https://www.swift.org/favicon.svg
Retrieved: 2026-10-04T14:52:42+00:00

Copyright: Copyright (c) 2021 Apple Inc. and the Swift project authors.
License: Apache-2.0 with Swift Runtime Library Exception; Apple branding
terms also apply
Terms: https://www.swift.org/LICENSE.txt
Terms: https://developer.apple.com/swift/resources/
The SVG header states the source license and copyright. Preserve that
header and the accompanying license. Apple permits the Swift logo in
technical publications describing the language; this is not a libtmux
product logo.

Validation: SVG XML parsed; no active or external image content. The
local asset SHA-256 matches the downloaded bytes.
why: Identify the selected language with a local upstream SVG.

what:
- Copy the SVG unchanged and record its SHA-256 and retrieval details
- Keep the existing libtmux artwork in menu options

Provenance: https://github.com/devicons/devicon/tree/7330accdbc47e2dc0c19789a48533c4a3c50fe58/icons/java
Source: https://github.com/raw/devicons/devicon/7330accdbc47e2dc0c19789a48533c4a3c50fe58/icons/java/java-original.svg
Upstream revision: 7330accdbc47e2dc0c19789a48533c4a3c50fe58
Retrieved: 2026-10-04T14:52:42+00:00

Copyright: Devicon collection: Copyright (c) 2015 konpa. Java and
related marks are trademarks of Oracle and/or its affiliates. The SVG
has no separate artwork copyright notice.
License: MIT for the Devicon copy; underlying Java logo rights are not
established by that license
Terms: https://github.com/devicons/devicon/blob/7330accdbc47e2dc0c19789a48533c4a3c50fe58/LICENSE
Terms: https://www.oracle.com/legal/logos/
This is a community SVG, not an Oracle-supplied asset. MIT does not
establish unrestricted rights to the Java logo. Oracle generally
requires authorization for its logos. No Oracle authorization is
recorded here; use is limited to identifying Java in the language
selector.

Validation: SVG XML parsed; no active or external image content. The
local asset SHA-256 matches the downloaded bytes.
why: Identify the selected language with a local upstream SVG.

what:
- Copy the SVG unchanged and record its SHA-256 and retrieval details
- Keep the existing libtmux artwork in menu options

Provenance: https://kotlinlang.org/docs/kotlin-brand-assets.html
Source: https://kotlinlang.org/assets/images/favicon.svg
Retrieved: 2026-10-04T14:52:42+00:00

Copyright: Kotlin brand assets are governed by the Kotlin Foundation
guidelines, which also preserve JetBrains copyrights. The supplied SVG
contains no separate copyright notice or year.
License: Kotlin Foundation icon-use terms
Terms: https://kotlinfoundation.org/guidelines/
The icon terms permit identifying Kotlin alongside other programming-
language icons. This is the icon, not the wordmark or Kodee mascot. Do
not imply Foundation endorsement or use it as the libtmux product icon.

Validation: SVG XML parsed; no active or external image content. The
local asset SHA-256 matches the downloaded bytes.
why: Identify the selected language with a local upstream SVG.

what:
- Copy the SVG unchanged and record its SHA-256 and retrieval details
- Keep the existing libtmux artwork in menu options

Provenance: https://github.com/scala/scala-lang/blob/06f69fd1db55358ba531d8c52f6740f118357f23/resources/safari-pinned-tab.svg
Source: https://www.scala-lang.org/resources/safari-pinned-tab.svg
Upstream revision: 06f69fd1db55358ba531d8c52f6740f118357f23
Retrieved: 2026-10-04T14:52:42+00:00

Copyright: Copyright EPFL, as stated by Martin Odersky in the linked
Scala user discussion. No artwork copyright year is specified.
License: General artwork license unresolved; historical noncommercial
logo-use permission
Terms: https://groups.google.com/g/scala-user/c/bCC-R0FQn1w
Terms: https://users.scala-lang.org/t/using-scala-logo/6332
Terms: scala/scala-lang#1040
The historical policy generally permits noncommercial Scala promotion.
The training discussion requires no implied endorsement. The explicit-
license issue remains open as of retrieval; do not label this SVG MIT,
CC0, or share-alike licensed.

Validation: SVG XML parsed; no active or external image content. The
local asset SHA-256 matches the downloaded bytes.
why: Identify the selected language with a local upstream SVG.

what:
- Copy the SVG unchanged and record its SHA-256 and retrieval details
- Keep the existing libtmux artwork in menu options

Provenance: https://github.com/dotnet/brand/tree/91845f6ddf2123b3bb1bfd1b6a386d9ce02b43aa
Source: https://github.com/raw/dotnet/brand/91845f6ddf2123b3bb1bfd1b6a386d9ce02b43aa/logo/dotnet-logo.svg
Upstream revision: 91845f6ddf2123b3bb1bfd1b6a386d9ce02b43aa
Retrieved: 2026-10-04T14:52:42+00:00

Copyright: The .NET logo and brand guidelines are copyright of the .NET
authors.
License: .NET custom brand-use permission
Terms: https://github.com/dotnet/brand/blob/91845f6ddf2123b3bb1bfd1b6a386d9ce02b43aa/README.md#license
Terms: dotnet/brand#10 (comment)
The README permits the logo in related content under the brand
guidelines. Maintainer Beth Massi explicitly permits the unmodified logo
to represent .NET itself. CC0 is stated for illustrations; this record
does not extend it to the logo.

Validation: SVG XML parsed; no active or external image content. The
local asset SHA-256 matches the downloaded bytes.
why: Identify the selected language with a local upstream SVG.

what:
- Copy the SVG unchanged and record its SHA-256 and retrieval details
- Keep the existing libtmux artwork in menu options

Provenance: https://foundation.fsharp.org/logo
Source: https://fsharp.org/img/logo/fsharp.svg
Retrieved: 2026-10-04T14:52:42+00:00

Copyright: The F# Software Foundation owns the logo asset. The logo
policy page carries a site copyright of 2012–2021; no separate artwork
year appears in the SVG.
License: F# Software Foundation logo-use terms
Terms: https://foundation.fsharp.org/logo
Use the unchanged logo to support the Foundation mission. Preserve
shape, colors and proportions, and do not imply representation of the
Foundation.

Validation: SVG XML parsed; no active or external image content. The
local asset SHA-256 matches the downloaded bytes.
why: The swift.org favicon was a globe, not the Swift language logo.

what:
- Copy Apple's supplied color SVG unchanged and record its SHA-256
- Replace the favicon provenance with Apple logo usage terms
- Remove the Apache notice, which does not license this replacement

Source:
https://developer.apple.com/swift/resources/images/swift_logo_color.svg
Provenance and terms:
https://developer.apple.com/swift/resources/
https://developer.apple.com/swift/downloads/swift-logo.zip
Retrieved: 2026-10-04T15:02:19+00:00
Copyright: Apple Inc.; the logo guidelines carry copyright 2018.
The SVG has no separate copyright year. Apple's custom guidelines
permit technical publications and require unmodified artwork, a white
bird, trademark attribution, a 30px minimum height and clear space.
No open-source license is asserted for the replacement logo.

Validation: SVG parsed; bytes match Apple's download. Visually checked
in the actual homepage selector with the bird rendered correctly.
why: The pinned-tab mark was hard to recognize, and the requested
upstream spiral includes a large empty canvas.

what:
- Retain upstream scala-spiral.svg byte for byte and crop icon.svg to
  the drawing bounds; preserve paths, gradients, colors and transforms.
- Source: scala/scala-lang resources/img/scala-spiral.svg at
  06f69fd1db55358ba531d8c52f6740f118357f23, retrieved
  2026-10-04T15:08:53+00:00.
- Copyright EPFL per Martin Odersky's linked statement; the artwork
  copyright year is unspecified. Historical noncommercial permission
  is documented without claiming a general artwork license.
- Record the repository license.md: its Apache-2.0 statement describes
  Scala software and does not explicitly grant an artwork license.
- Keep exact URLs, source and derived hashes in provenance.json.

validation: Both SVGs parse and their drawing elements compare equal.
Independent source/crop review and light/dark browser checks pass.
Upstream whitespace is retained intentionally in both SVG copies.
why: The selected homepage language should have a recognizable icon
without changing menu-option artwork or the height of the controls.

what:
- Opt only the homepage trigger into the locally copied language SVGs.
- Keep the code glyph for an unset selection and resolve stored/URL
  choices before paint. Reset clears that explicit choice.
- Keep images inside an 18px box, including non-square artwork, with
  critical visibility and dimensions in the head stylesheet.
- Add visible source/terms notices and retain Swift's documented
  compact-display exception to its brand sizing guidance.
- Extend existing state and browser checks to inspect actual images,
  default/reset behavior and unchanged menu artwork.

validation: Independent 78-case geometry matrix passes in light/dark
at 280, 390 and 1440px. URL/storage/history and no-JS checks pass.
Workspace lint and unit suites pass; Astro checks 275 files with no
errors or warnings. The outer browser check exceeded its 60s budget.
The full homepage helper separately reports an F# code-width failure;
this commit does not claim that whole helper or publication is green.
why: The bulb's major arc extended above the SVG viewport, clipping
its top in documentation menus.

what: Reduce the arc radius so the path and its stroke fit inside
0..20 without changing the menu or SVG dimensions.

validation: Light/dark browser checks at 914, 390 and 280px pass.
Independent checks reproduce clipping with the old radius and confirm
the new stroke bounds remain inside the viewport.
why: The F# homepage example overflowed its desktop panel even when
its source line fit the configured character limit.

what:
- Reserve enough container width for rounded monospace advances.
- Keep the existing readable font bounds and narrow-screen scrolling.

checks: All 13 examples fit at 1093px in both themes. Font sizes stay
within 13–15px at 906px, 1135px and 1920px. The outer loop exceeded
its 60-second budget and a publication-fixture test timed out;
focused browser evidence is recorded separately.
why: Plain manual code hid tmux directives and formats, while
individual definitions could not be linked within their sections.

what:
- Add a tmux configuration grammar using the shared syntax palette.
- Highlight manual examples and CLI synopsis without changing text.
- Give definition entries section-scoped, case-aware permalinks.
- Preserve upstream links and distinguish runtime formats from shell
  variable expansion inside single-quoted strings.

checks: Independent source and browser review covered both pinned
versions and themes, narrow no-JavaScript anchors, source preservation,
and negative controls. Astro check reported zero errors. The outer
loop's only unit failure is an expected guide-URL change in the
separate route migration; its browser/type phases did not complete.
why: tmux documentation should identify the terminal multiplexer and
its author rather than inherit the Python library's title and schema.

what:
- Use page, section, tmux and libtmux.org in document and sharing titles
- Describe tmux in structured data and link its official project
- Use the upstream tmux artwork for metadata and the page icon
- Keep library branding on language-specific documentation

Focused branding checks, the site type check, and local English and
Japanese rendered metadata checks passed. These checks do not establish
public deployment.
why: Shared tmux guides, topics, concepts and examples need one home
separate from language libraries. A numbered manual must not imply that
these unversioned sections belong to that tmux release.

what:
- Serve shared prose only below the tmux portal
- Keep library-specific routes within their port and version
- Update navigation, backlinks, Markdown, search and LLM exports
- Preserve real translations and omit placeholders from the sitemap
- Offer Current docs and the selected manual on numbered versions
- Update browser checks for the shared context and tmux destination

Validation: focused route, export, translation and rendered navigation
checks pass, with independent review of the exact file hashes. The broad
browser run hit two homepage load timeouts; the required outer run passed
units and type checks before its fixed 60-second cutoff.
why: Crawlers and saved links should reach the canonical tmux portal.

what: Issue permanent redirects for shared guides, topics, concepts and examples while retaining paths and query parameters. Match the independently reviewed tf-config function without applying infrastructure.

Validation: VM regression cases cover localized and preview paths, assets, exclusions and repeated query parameters.
why: The official artwork reserves canvas space below the snakes for a shadow, which makes the visible mark sit above the menu label.

what: Move only the homepage trigger image down 1.5 pixels. Preserve the supplied SVG bytes, fixed 18-pixel icon box and 36-pixel trigger height.

Validation: Inspect the 914-pixel rendered header; retain geometry checks with a two-pixel allowance for optical alignment.
why: Readers can compare languages and color schemes before committing
to a choice. A brief pass over a control should not change the page.

what:
- Preview after 1.2 seconds, with a 180 ms fade unless motion is reduced
- Keep saved choices, query parameters and checked controls unchanged
- Restore on leave, Escape and navigation; commit only on selection
- Keep prompts and packages synchronized with the previewed language
- Restrict previews to the homepage and preserve touch behavior

Validation: focused browser checks and independent state, motion,
keyboard, touch and navigation review pass. Required outer validation
remains incomplete at its fixed 60-second limit.
tony added 20 commits October 4, 2026 12:36
why: Readers need to return to the default prompt and share a URL without an explicit task.

what: Clear the task query and saved value while retaining language, unrelated parameters and the fragment. Keep Reset, reroll and the shrinking task selector in one row; retain the full description as a tooltip at narrow widths.

Validation: real browser selection, reroll, reload, fragment history, focus and storage-blocked cases pass. Controls remain on one row at widths from 280 to 914 pixels, with independent review.
what: Show every homepage main program in full, including imports, server construction and operation context. Check preview equality with the native-tested file and cap expanded source lines at 80 columns. Shorten one F# comment.

why: Task-only excerpts hid required values such as the TypeScript server and cancellation signal. Readers need the setup visible, with source widths that fit the example panel.
why: The Run this example disclosure already points readers to setup.

what: Remove the repeated complete-program caption above it.
why: Six examples required hidden bootstrap scripts or positional inputs, so copying the displayed program could not start the example.

what:
- Initialize private servers in C++, Java, Kotlin, Scala, Lua and Swift.
- Use a bounded public output wait in Swift.
- Remove the bootstrap scripts and bind fixtures to each native run.
- Verify all six displayed programs against their pinned libraries.
why: Language icons were smaller than the adjacent solution artwork.
Python also needs its image dimensions constrained independently of
its intrinsic aspect ratio.

what:
- Use a shared 24px artwork box while keeping 36px buttons.
- Scale the measured Python optical adjustment with the image.
- Check all selected icons and both selector heights in the browser.
- Keep the Swift provenance display-size note accurate.
why: Dense setup and consecutive operations make working examples harder
  to scan, especially beside the homepage introduction.

what:
- Separate setup, operations and cleanup while keeping error checks with
  the operation they describe.
- Expand crowded multiline arguments and deferred cleanup bodies.
- Preserve complete programs and update their displayed-source hashes.

Validation: All 13 programs fit 80 columns with eight-column tabs. All
12 changed programs pass fresh native runs against pinned libraries and
tmux 3.7d. Independent review confirms preserved program behavior and
61 focused tests pass, with three assembled-output skips. The outer run
passes unit and type checks but reaches its 60-second browser-check
budget; the full outer gate remains incomplete.
why: Readers need concise programs without losing the definitions and
checks required to run them, plus optional diagnostics and cleanup.

what:
- Add four complete, independently verified views for all 13 ports
- Copy the visible program and keep its setup and lifetime explicit
- Flatten error and cleanup scopes and keep source lines within 80 columns
- Record each program's hashes and observe only its owned tmux endpoints

Verification: 52 retained native program receipts, 152 focused tests, and
all 52 displayed copy payloads checked. Three assembled-output checks
were skipped. The outer gate exceeded its fixed 60-second limit.
why: Narrow headers wrapped early, task names changed the picker width,
and separate reset links used space needed by the controls.

what:
- Put accessible clear buttons before each picker chevron
- Use the searchable task menu with a fixed width and matching reroll
- Give task descriptions two lines and preserve full language names
- Fit the header on one row when space permits and cycle compact themes
- Handle task selection before Astro starts link navigation

Verification: isolated browser checks cover 280-914px layouts, task
choices, keyboard interaction, URL state and colour-scheme persistence.
Independent rendered checks and workspace type checks passed. The
combined outer gate exceeded its unchanged 60-second budget.
why: Error handling and cleanup are reader preferences that should
survive language changes, reloads and shared homepage links.

what:
- Share both checkbox choices across all language examples
- Save enabled choices in local storage and errors/cleanup GET parameters
- Let explicit zero override saved values and remove unchecked parameters
- Restore history choices without changing documentation URLs

Verification: isolated and independent browser checks passed for all
13 ports, reloads, Back/Forward, explicit zero, cleared choices,
unrelated URL state and blocked local storage. Type checks passed.
The combined outer gate remains incomplete at its fixed 60-second limit.
The compact layout hides the radio group and shows a cycling button.
Keep the same geometry assertions and measure the visible control.

Verified at six widths with and without JavaScript; the previous
selector fails the 390px JavaScript case as expected.
why: The growing browser matrix cannot fit the outer loop's fixed budget
and was absent from the publication gate.

what:
- Keep a fresh-source rendering sample in the 60-second outer loop
- Run the full matrix during publication with provisioned Chromium
- Limit competing browser checks and close their completed pages
- Measure the visible responsive theme control in navigation checks
why: Homepage selections restore on popstate before Astro finishes its
query-changing Forward navigation. Measuring or clicking the old document
can race the body swap and fail an otherwise correct browser check.

what:
- Wait for the router page-load event before checking the restored page
- Retain every selection, URL, geometry, and copy assertion
- Reuse the existing transition wait for example-option history checks
what: Use one border at the tab and code-panel seam. Remove attached frame
upper borders and corners, including titled editor frames.

why: The overlapping strip and frame borders left doubled lines and rounded
corners at the join. Standalone frames and terminal decorations stay intact.
what: Exclude focused header controls from the document scroll offset used
for article anchors. Check pointer, arrow-key, and compact theme switching
while scrolled down the tmux hierarchy page.

why: Native radio focus treated the sticky header as an obscured target and
scrolled the article upward before applying the chosen colour scheme.
why: Keep the solution picker visually lighter at rest.

what:
- Show the themed border on hover, reserving its width at rest
- Preserve existing keyboard focus outlines
tony added 2 commits October 4, 2026 20:29
why:
Shared guides moved beneath tmux, while agent prompts still cited their
former root paths. The publication audit correctly rejected those URLs.

what:
Use the shared tmux namespace in prompt guide links and verify production
and localized preview prefixes. Keep the shared prompt payload below 41 kB
after the extra path segment, with the deduplication check unchanged.

validation:
Focused prompt checks and the old-path negative control pass. The outer
loop passes in 39.69 seconds.
why:
The output harness skipped the imported install-widget bundle, counted
tmux as a language counterpart, and read guides at their former paths.

what:
Execute built widget modules with their static imports in isolated DOM
scopes. Check tmux separately from language destinations and retain the
breadcrumb audit. Read row-anchor and code-tab fixtures below tmux.

validation:
The focused built-page checks pass, including installer interactions and
all product switchers. Old module loading and destination counting fail
negative controls. The outer loop passes in 39.69 seconds.
@tony
tony marked this pull request as ready for review October 5, 2026 02:11
@tony
tony merged commit adfce73 into main Oct 5, 2026
3 checks passed
@tony
tony temporarily deployed to docs-preview-cleanup October 5, 2026 03:06 — with GitHub Actions Inactive

This branch was previously deployed

2 inactive deployments
docs-preview-cleanup — 28d35c59 Deployed Oct 5, 2026 by tony via cleanup #95
docs-preview — 28d35c59 Deployed Oct 5, 2026 by tony via publish-preview / publish #529
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