docsgen

package
v0.3.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 13, 2026 License: AGPL-3.0, AGPL-3.0-only Imports: 7 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func GenerateCLIReference

func GenerateCLIReference(root *cobra.Command) string

GenerateCLIReference walks the Cobra command tree and emits a complete CLI reference markdown document. Hidden commands are omitted.

func GenerateConfigReference

func GenerateConfigReference() string

GenerateConfigReference emits a complete config reference markdown document. Fields are discovered via reflection on the config structs. The override maps provide curated descriptions, allowed values, defaults, and notes.

Types

type FieldOverride

type FieldOverride struct {
	Description   string
	AllowedValues []string
	Default       string
	Required      *bool // override omitempty heuristic
	Example       string
	Notes         []string
}

FieldOverride provides per-field documentation enrichment.

type SectionOverride

type SectionOverride struct {
	Summary string   // what this section governs
	Example string   // inline YAML snippet
	Notes   []string // gotchas, special semantics
}

SectionOverride provides framing and context for a top-level config key.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL