Skip to content

ci(docs) Update the docs pages and builds - #854

Merged
tony merged 1 commit into
docs-site-deployfrom
docs-publisher-a914a8244
Nov 12, 2026
Merged

tony merged 1 commit into
docs-site-deployfrom
docs-publisher-a914a8244

Conversation

@tony

@tony tony commented Nov 12, 2026

Copy link
Copy Markdown
Member

Pin only the shared port builder and publisher to a914a82442dbd1be9d7b799d3019db203474ade3 from cfa8a14960f4b68c182c687672086f19840b1fc9. All other workflow bytes, library contents, triggers, permissions and language/source/version inputs remain unchanged.

  • Read the product status bars a reader has dismissed in the page's head, with the theme settings every page applies before it paints, and hide a dismissed bar with one stylesheet rule per status, so a dismissed bar is never drawn (ThemeScript.astro, global.css)
  • Draw the icon of a link that leaves the site in the first paint: the build writes the external-link marker into the HTML of every page, and of the native reference pages, so the icon no longer appears after the page loads and shifts the text after it (external-links.ts, mark-external-links.mjs, build-site.sh)
  • Show the in-development status of the MCP server as a dismissible bar under the page header, on every MCP page, where each page opened with it as an admonition inside the article: dismissing a bar hides that note on every page that carries it, a reader without scripts keeps it, and a page's Markdown twin leads with the same sentence (ProductNotice.astro, DocsLayout.astro, BaseLayout.astro, markdown-twins.ts)
  • Show "No matching page" with a link to the language home, in the language picker of an MCP or Workspace Manager overview, for a port that publishes no such product, where the row linked to a page that said the product was not published (ports.ts, docs-paths.ts)
  • Link the Server, Session, Window and Pane reference pages to Haskell's counterpart, in the language picker and in the list of the same concept in other ports, and the Server page to Common Lisp's client (concepts.ts)

A bar hidden only after the page loaded would flash on every page a reader had already dismissed it on. A link to another site grew its icon after the page had loaded and pushed the text after it along. Every MCP page opened with an admonition that a reader could not close, the same sentence on every page of the product. The language picker of an MCP or Workspace Manager overview offered the page of a port that has no such product. A reader on a Server, Session, Window or Pane page could not jump to the same concept in Haskell, and the Server page had no link to Common Lisp's.

The exact required CI and root merge receipts of the shared checkpoint must be verified before this operator runs. This PR does not claim an owner build or publication pass. Root reviews this exact caller diff, actual repository-required checks and reviews before merge; optional native estate checks are not a new universal gate.

Execution route: exact_source_manual_dispatch_after_root_controlled_pin_merge. Root separately schedules reviewed merges and exact source requests from the actual workflow state. If the current active workflow already publishes the intended source on merge, retain that actual event and do not issue a duplicate request. Future source/native/run identities will be bound to actual events.

why: A bar hidden only after the page loaded would flash on every page a
reader had already dismissed it on. A link to another site grew its icon
after the page had loaded and pushed the text after it along. Every MCP
page opened with an admonition that a reader could not close, the same
sentence on every page of the product. The language picker of an MCP or
Workspace Manager overview offered the page of a port that has no such
product. A reader on a Server, Session, Window or Pane page could not
jump to the same concept in Haskell, and the Server page had no link to
Common Lisp's.

what:
- Read the product status bars a reader has dismissed in the page's
  head, with the theme settings every page applies before it paints, and
  hide a dismissed bar with one stylesheet rule per status, so a
  dismissed bar is never drawn (`ThemeScript.astro`, `global.css`)
- Draw the icon of a link that leaves the site in the first paint: the
  build writes the external-link marker into the HTML of every page, and
  of the native reference pages, so the icon no longer appears after the
  page loads and shifts the text after it (`external-links.ts`,
  `mark-external-links.mjs`, `build-site.sh`)
- Show the in-development status of the MCP server as a dismissible bar
  under the page header, on every MCP page, where each page opened with
  it as an admonition inside the article: dismissing a bar hides that
  note on every page that carries it, a reader without scripts keeps it,
  and a page's Markdown twin leads with the same sentence
  (`ProductNotice.astro`, `DocsLayout.astro`, `BaseLayout.astro`,
  `markdown-twins.ts`)
- Show "No matching page" with a link to the language home, in the
  language picker of an MCP or Workspace Manager overview, for a port
  that publishes no such product, where the row linked to a page that
  said the product was not published (`ports.ts`, `docs-paths.ts`)
- Link the Server, Session, Window and Pane reference pages to Haskell's
  counterpart, in the language picker and in the list of the same
  concept in other ports, and the Server page to Common Lisp's client
  (`concepts.ts`)

Shared source: libtmux/docs
From: cfa8a14960f4b68c182c687672086f19840b1fc9
To:   a914a82442dbd1be9d7b799d3019db203474ade3
@codecov

codecov Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 52.45%. Comparing base (528d2e6) to head (e827910).

Additional details and impacted files
@@                 Coverage Diff                  @@
##           docs-site-deploy     #854      +/-   ##
====================================================
+ Coverage             52.37%   52.45%   +0.08%     
====================================================
  Files                    26       26              
  Lines                  3729     3729              
  Branches                747      747              
====================================================
+ Hits                   1953     1956       +3     
+ Misses                 1472     1469       -3     
  Partials                304      304              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@tony
tony merged commit d8e4d2d into docs-site-deploy Nov 12, 2026
24 of 25 checks passed
@tony
tony deleted the docs-publisher-a914a8244 branch November 12, 2026 13:35
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