Multiline doc description for struct fields

[jc-fireball]

I am migrating my existing services to huma. Part of the job is to move openapi API doc along with the code so we don't need to maintain code and doc yaml.

Right now we have one challenge which is multiline description for struct field. More specifically this is for the enum types. In the API doc, we want to not only list out all enum values but also add descriptions for each of the values (kind like a table) .

Few options:

1. Go tag: Go tag must be oneline. If we make the table into oneline but it will be difficult to maintain for developers.
2. custom Enum type:

type Status string

var FailStatus Status = "fail"
var SuccessStatus Status = "success"

func (s Status) Schema(r huma.Registry) *huma.Schema {
	des := `The status value
| Enum Value        | Description |
|-----|-----------|
| fail   | fail status |
| success  |  success status |
`
	return &huma.Schema{
		Type:        "string",
		Description: des,
		Enum:        []any{FailStatus, SuccessStatus},
	}
}

type Request struct {
  Body struct {
     Status Status `json:"status"`
  }
}

This works well to list out all enums. But the description from Status schema isn't passed to Status field in request body. I checked the code of Huma, it basically only use the doc tag from the Status field. line: https://github.com/danielgtaylor/huma/blob/main/schema.go#L491

I am wondering if Huma can add some support to inherit or reference the doc/description from custom type to the struct field so that it can resolve 90% large field description issue.