Help us shape the future of Go! Take the 2026 Go Developer Survey

docs

package
v0.10.9 Latest Latest
Warning

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

Go to latest
Published: Oct 11, 2026 License: MIT Imports: 8 Imported by: 0

Documentation

Index

Constants

View Source
const (
	FormatMarkdown = "markdown"
	FormatYAML     = "yaml"
)

Define output format types

Variables

This section is empty.

Functions

func GenerateMarkdown

func GenerateMarkdown(writer io.Writer, appInfo AppInfo) error

GenerateMarkdown is a convenience function to generate markdown documentation directly

func GenerateYAML

func GenerateYAML(writer io.Writer) error

GenerateYAML is a convenience function to generate YAML configuration template directly

Types

type AppInfo

type AppInfo struct {
	BinaryName  string
	EnvPrefix   string
	ConfigPaths struct {
		DefaultPath     string
		DefaultFullName string
	}
}

AppInfo contains information about the application needed for documentation generation

type Config

type Config struct {
	OutputFormat string
	OutputFile   string
	Writer       io.Writer
	Registry     RegistryFunc
}

Config holds all configuration for document generation

type Generator

type Generator struct {
	// contains filtered or unexported fields
}

Generator handles document generation based on configuration

func NewGenerator

func NewGenerator(cfg Config) *Generator

NewGenerator creates a new document generator with the given configuration

func (*Generator) Generate

func (g *Generator) Generate() error

Generate produces documentation in the configured format

func (*Generator) GenerateMarkdownDocs

func (g *Generator) GenerateMarkdownDocs(w io.Writer, appInfo AppInfo) error

GenerateMarkdownDocs generates Markdown documentation for all configuration options

func (*Generator) GenerateYAMLDocs

func (g *Generator) GenerateYAMLDocs(w io.Writer) error

GenerateYAMLDocs generates a YAML configuration template

func (*Generator) SetAppInfo

func (g *Generator) SetAppInfo(info AppInfo)

SetAppInfo sets the application information used for documentation

type RegistryFunc

type RegistryFunc func() []config.ConfigOption

RegistryFunc defines a function that returns a configuration registry This is primarily used for testing to mock the registry

Jump to

Keyboard shortcuts

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