Skip to content

Update flox.md command list and SEE ALSO section #414

@stahnma

Description

@stahnma

Problem

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.


Via Forge (interactive) • 2ee017e

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions