Skip to content

Document internal help page generation flow - #3326

Closed
gdesai23 wants to merge 1 commit into
pallets:mainfrom
gdesai23:docs-help-generation-flow
Closed

gdesai23 wants to merge 1 commit into
pallets:mainfrom
gdesai23:docs-help-generation-flow

Conversation

@gdesai23

@gdesai23 gdesai23 commented Apr 7, 2026

Copy link
Copy Markdown

Summary

This documents the current internal flow for generating help pages in Click.

It covers:

  • the explicit --help path
  • the no_args_is_help path
  • how Context.get_help() delegates to Command.get_help()
  • how Command.format_help() assembles help sections
  • how Group.format_commands() adds the commands section
  • the role of HelpFormatter in rendering output

Why

Issue #3094 asks for documentation of the current help page generation path so maintainers have a shared understanding before making help-related changes.

Fixes #3094

@davidism davidism closed this Apr 7, 2026
@github-actions github-actions Bot locked as resolved and limited conversation to collaborators Apr 22, 2026
@kdeldycke kdeldycke added the rejected AI Contribution rejected because of its untrustworthy AI origin label Aug 8, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

rejected AI Contribution rejected because of its untrustworthy AI origin

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document help page generation for maintainers

3 participants