Documentation: Feature showcase

[myhau]

Acceptance criteria

Create a nice markdown page and link from README.md (or extend README.md)

Cover these features:

Maps and lists + maps/lists with type-safe builder values.

Examples

field("key1", "key2")

field("key" to "value", "key1" to "value2")

field("key" to {
    field2("whatever")
})

field(
  {
        field2("whatever")
  },
  {
      field2("whatever")
  }
)

Enums

vmType(XD_64)

Custom resource options (opts)

You can pass String, but also Output

Resources and functions combined (mention coroutines vs Future)

var futureResult = AwsFunctions.getProjectPlain().get()

ResourceArgs.builder().field(futureResult)

vs

val project = AwsFunctions.getProjectPlain()

resource {
    field(project)
}

Recommendations on how to break huge blocks into smaller ones (extract functions)

More to be discussed...