You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The top-level flox.md command reference page omits entire command categories from both the COMMANDS and SEE ALSO sections. Commands like build, containerize, publish, envs, gc, generations, services, and include are missing.
The SEE ALSO section links to only 15 of the 31 man pages in docs/man/.
The current command groupings ("Local Development", "Sharing", "Additional") don't match the CLI's actual category structure (Manage, Use, Discover, Modify, Share, Admin).
Acceptance Criteria
COMMANDS section lists build, containerize, publish, envs, gc, generations, services, and include with one-line descriptions
Command groupings match the CLI's actual category structure (Manage, Use, Discover, Modify, Share, Admin)
SEE ALSO section links to all 31 man pages in docs/man/
No dead links in the SEE ALSO section
Docs site builds without errors
Context
Addresses ST-001 from the Floxdocs Audit effort. Also relates to floxdocs item 15 (documentation-facing domain overview).
This is the highest-visibility gap: the main entry point to CLI reference omits entire command categories.
Approach
Compare the CLI command source (cli/flox/src/commands/) against docs/man/flox.md to identify missing entries. Add missing commands under appropriate category headings. Update SEE ALSO with a complete, sorted list of man page links.
Problem
The top-level
flox.mdcommand reference page omits entire command categories from both the COMMANDS and SEE ALSO sections. Commands likebuild,containerize,publish,envs,gc,generations,services, andincludeare missing.The SEE ALSO section links to only 15 of the 31 man pages in
docs/man/.The current command groupings ("Local Development", "Sharing", "Additional") don't match the CLI's actual category structure (Manage, Use, Discover, Modify, Share, Admin).
Acceptance Criteria
build,containerize,publish,envs,gc,generations,services, andincludewith one-line descriptionsdocs/man/Context
Addresses ST-001 from the Floxdocs Audit effort. Also relates to floxdocs item 15 (documentation-facing domain overview).
This is the highest-visibility gap: the main entry point to CLI reference omits entire command categories.
Approach
Compare the CLI command source (
cli/flox/src/commands/) againstdocs/man/flox.mdto identify missing entries. Add missing commands under appropriate category headings. Update SEE ALSO with a complete, sorted list of man page links.Via Forge (interactive) • 2ee017e