Workspace reference generation
libtmux-workspace 0.0.1-alpha.12-SNAPSHOT · Source
The native Java CLI derives help and exports from its parser definitions. Compatibility records current coverage.
Command metadataLink to section
Picocli defines the native command graph. --generate schema exports metadata
and --generate bash emits completion through its code generator. Other manual
and completion formats are not exposed by the workspace executable.
Bash generation also supports a JSON artifact or one completed NDJSON event; the script remains a string inside the machine result. Schema generation keeps its metadata document. See machine completion output.
The command reference covers the Python grammar. Native metadata exports need to record command paths, aliases, positional arity, option spellings, types, defaults, choices, required and exclusive groups, store-constant values, repeat and ordering behavior, environment bindings, and child commands. Output schemas and availability belong alongside that metadata.
Generate help, completion, and static reference from the same definitions. Compare generated results in CI and test actual installed help separately. A rendered example or successful parser-only probe does not establish service execution, distribution, or tmux compatibility.
Site integrationLink to section
Keep equivalent task pages at the same workspace path in every port. The existing page switcher offers authored counterparts and leaves absent pages unavailable. A CLI guide and a builder API guide are different counterparts; preserve builder reference as its own surface.
Write executable shell examples per port. Shared console, YAML, and JSON blocks survive language filtering. Installing a native library must not be presented as installing a workspace executable when it has no such artifact.
The site version and workspace package version can differ. Record the package and source revision independently, and do not use an older version-shaped URL to imply that today’s command existed in an older release. The installation guide identifies the available source builds and published artifacts.
VerificationLink to section
Check configuration, machine output, and compatibility together. Exercise equivalent page paths, API backlinks, fragments, sidebars, metadata exports, search, and preview prefixes in assembled output. Verify command examples against isolated tmux servers, with explicit cleanup and known limitations.