I've been using Sourcery to generate documentation automatically for GitHub wiki (i.e. generate markdown files based on types & annotations), as it's pretty user friendly on there (as in "easy to read") and also very easy to do in templates thanks to Sourcery's capability to generate files on the fly.

However, using annotations is not very "coder-friendly" though, as it gets hard to maintain be

Currently on generating the following is created:

    fun url title -> 
        { url = url
          title = title } 
    |> fun f -> withFields (f)
    |> fun codec -> 
        let decode = fst codec
        let encode = snd codec
        jfieldOpt ("url") (fun x -> x.url) (decode, encode)
    |> fun codec -> 
        let decode = fst codec
        let encode = snd codec
     

Now that templates are packages, we could use a custom key on the package.json file instead of having our own entire file. For instance:

// package.json
{
  "name": "my-template",
  "version": "0.1.0",
  "asyncapi-generator": {
    "supportedProtocols": ["amqp", "mqtt", "kafka", "ws"],
    "parameters": {
      "server": {