docgen

type Doc struct {
	Title       string
	Version     string
	Description string

	Endpoints []Endpoint
	HTMLs     []HTMLEndpoint
	Objects   []Object

	SkipMetadata bool // skip header metadata
}

type DocumentInfo struct {
	Summary     string
	Description string
}

type Endpoint struct {
	Method      string
	Path        string
	OperationID string
	DocumentInfo

	HtmlID string
	Tags   string

	Input      Object
	OutputList []Object
	HasExample bool

	GoPositionURL string
}

type Example struct {
	Title       string
	Description string
	Value       string
}

type HTMLEndpoint Endpoint

type Link = info.Link

type Object struct {
	Name        string
	TypeExpr    string
	TypeString  string
	ContentType string
	DocumentInfo

	HtmlID   string
	Links    []Link
	Examples []Example
}