From e82791018b0febd38cf1fcc17c0848314dd8ee9d Mon Sep 17 00:00:00 2001 From: Tony Narlock Date: Thu, 12 Nov 2026 06:52:31 -0600 Subject: [PATCH] ci(docs) Update the docs pages and builds 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 --- .github/workflows/docs.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 2fae6f93e..02421d94a 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -51,7 +51,7 @@ permissions: jobs: build-libtmux-org: - uses: libtmux/docs/.github/workflows/port-docs.yml@cfa8a14960f4b68c182c687672086f19840b1fc9 + uses: libtmux/docs/.github/workflows/port-docs.yml@a914a82442dbd1be9d7b799d3019db203474ade3 with: port: py source-ref: ${{ inputs.source-ref }} @@ -75,7 +75,7 @@ jobs: permissions: contents: read id-token: write - uses: libtmux/docs/.github/workflows/reusable-deploy.yml@cfa8a14960f4b68c182c687672086f19840b1fc9 + uses: libtmux/docs/.github/workflows/reusable-deploy.yml@a914a82442dbd1be9d7b799d3019db203474ade3 with: path-prefix: py/${{ matrix.version }} artifact: docs-py-${{ matrix.version }}