# Workspace reference generation

Source: https://libtmux.org/en/ts/latest/workspace/internals/documentation/

> Generate command references from the parser and verify task examples against the CLI.

**Workspace Manager concept example** A working example of the core library. It can change without notice.



The executable's parser owns its command names, arguments and options. Keep
reference generation tied to those definitions.

## Command metadata

Commander owns the command definitions. The package generates Markdown, a JSON command catalog and completion scripts from those definitions. `docs:check` checks their freshness.

See [shell completion](https://libtmux.org/en/ts/latest/workspace/cli/completion/) for end-user setup. A generated
parser reference describes syntax; task examples also need to exercise the
underlying services and their cleanup.

## Site integration

Record the CLI's own source revision independently from the core library
reference. Keep commands, configuration and examples specific to that source.
Use the same content selection for HTML, search, Markdown and machine exports.

Verify guides against a private tmux server, with cleanup limited to the objects
the test owns. Check failure cases as well as successful construction.

[CLI source](https://github.com/libtmux/libtmux-ts/blob/f36d692552bb9a373b45338bb5fece854e57cc3d/packages/workspace-cli/README.md).