Add complete attach examples and a shell-first guide - #56
Merged
Merged
Conversation
This was referenced Sep 30, 2026
why: The shared attach guide mixed language snippets without imports or setup. Readers need complete programs and a shell-first tmux explanation. what: - Teach terminal attachment and socket selection with tmux commands - Add complete existing-server examples for all thirteen language ports - Include project files, pinned dependencies and isolated launchers - Preserve native program bytes in HTML, Markdown and Copy buttons - Link temporary testing helpers to the regular Server API - Enforce a 100-column limit for example comments
tony
force-pushed
the
docs-attach-examples
branch
from
September 30, 2026 08:08
42288a2 to
638db5f
Compare
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
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 shared attach guide now teaches tmux terminal commands and a complete shell script. The port menu opens a complete program for each of the thirteen languages, including imports, project files, pinned dependency setup and an isolated server launcher. Each program finds the exact
worksession and leaves the existing server running.Examples that use testing helpers retain them, with a short note linking the port’s regular
ServerAPI. Example comments have a 100-column limit, including indentation.Verification
work-extrais rejected on 3.7c. Existing servers survived both success and failure cases; all isolated fixtures were removed.The native runner is
python3 scripts/check-example-prose.py --example attach --port <port> --output-dir <new-directory>, with that port’s native tools and tmux onPATH. The fixture records exact source revisions, commands and file hashes. Native execution is separate from the routine site test loop.