Improvement: Documentation for slices of custom types

[mwmahlberg]

It is unclear to me how something like this should be done properly:

type WebhookConfig struct {
  Name string
  URL  string
}

var config {
  Webhooks []WebhookConfig
}

especially in conjunction with https://github.com/alecthomas/kong-yaml

Implementing a custom MapperDecoder or json.Unmarshaller seems a bit cumbersome, taking a rather common configuration like:

webhooks:
    - name: "foo"
      url: "bar"
    - name: "bar"
      url: "baz"

into account. Am I right to assume that a custom Decoder/Unmarshaller is required in this case?

[alecthomas]

You are correct. It's not clear to me how this could be any more convenient though, given that Webhooks must also be exposed via flags?

That said however, in this particular instance you could potentially just use a map.

[alecthomas]

On further reflection this is not possible as Kong always assumes that structs without cmd are invalid unless they implement the decoder interface.

[costela]

For the record: this should be fixed with https://github.com/alecthomas/kong-yaml/pull/15#issue-1601121303 :crossed_fingers: