Keep the root workspace example focused on tmux - #54
Merged
Merged
Conversation
why: The shared workspace page repeated incomplete language excerpts and long source inventories beside existing complete port examples. what: - Show a complete tmux command file and isolated shell program at the root - Keep compact port links and the existing source-section anchors - Redirect legacy port example paths to their owned workspace pages - Regenerate API mentions and remove the three unused source excerpts - Protect native program bytes and forward/reverse port routing verification: Sixteen native cases pass on tmux 3.2a and 3.7c, including parse errors, partial creation, shutdown errors and control isolation. Foreign-language and missing-alias controls fail as expected. The outer local gate passes in 47.89 seconds.
why: A static meta refresh discards an incoming section fragment and query string. Existing workspace example citations stopped at the top of the new page after moving to the complete port examples. what: - Share a redirect page between guide aliases and port-home fallbacks - Carry the query string and fragment to the canonical destination - Keep a noindex canonical page and JavaScript-disabled meta fallback - Retain legacy source-section anchors on the eight workspace examples - Exercise section links and the no-JavaScript path in the browser gate verification: The built old Go alias drops its source-section fragment. The fresh-source browser gate keeps the fragment and query, finds the legacy anchor, and reaches the page with JavaScript disabled. The full outer local gate passes in 47.51 seconds.
why: The Python workspace example now shares its task alias with the native builder examples. The publication test still expected only the old same-section routes and rejected the valid seven new links. what: - Check each canonical counterpart, including the native Internals pages - Keep same-section expectations for other product pages and versions - Require every expected counterpart destination to exist Verification: Reproduced the CI assertion locally, then passed the focused assembled-output check and the full local gate in 51.28 seconds.
tony
added a commit
that referenced
this pull request
Sep 30, 2026
what: - Teach the root task with a complete tmux shell program and config - Link compactly to the corresponding port-owned examples - Preserve query strings and fragments through static redirects why: Repeated language excerpts and source inventories obscure the shared tmux task. Complete programs belong on their port pages, and existing links must continue to reach the intended source section.
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The root workspace example repeats incomplete language excerpts and long source inventories beside complete port examples. It now teaches tmux with a command file and a complete shell program, followed by compact port links and one manual citation. The eight existing port URLs lead to their owned examples, preserving source-section links and port switching.
Static redirects now retain query strings and section fragments. The shared redirect page also supplies the port-home fallback and keeps a canonical URL, noindex metadata, a visible link, and a meta refresh for browsers without JavaScript. Three unused source excerpts and their stale API backlinks are removed.
Verification covers English latest output and Linux:
ShellCheck reports SC2329 for the cleanup function called through the EXIT trap. Native failure cases exercise that callback; the warning is not suppressed.