Have minimum viable examples in addition to the huge sprawling ones.

[Panzerbjrn]

I would like to suggest the the deployment references should at the very least, always contain one example that has the minimum viable Bicep code needed for a successful deployment. Ideally at the top off the list of the Quickstart Templates.

For example, if I go to Microsoft.Network publicIPAddresses, and take a look at the quickstart templates, I get these huge files which are mostly not relevant to what I want, which is info about how to create a publicIPAddresses so I can attach it to a VM.

This seems to be the case in many places, and the documentation would be vastly improved by providing more examples like this.

[StefanIvemo]

Have you seen the snippets that are available via the VS Code extension? Just type res- in your editor and you will find a list with single resource snippets that can be a good starting point.

[Panzerbjrn]

Thanks, that is useful to an extent, but there are two issues I spot immediately:

1. This should really be in the deployment reference, or a help file linked to from the deployment reference.
2. It is missing the public ip addressing that I'm after specifically, so apparently only useful for some things. I tried res-ip, res-pub and res-netw, so some work is still needed there.

[brwilkinson]

So this is not what you were looking for?

resource publicIPAddress 'Microsoft.Network/publicIPAddresses@2019-11-01' = {
  name: 'name'
  location: location
  properties: {
    publicIPAllocationMethod: 'Dynamic'
    dnsSettings: {
      domainNameLabel: 'dnsname'
    }
  }
}

[brwilkinson]

@Panzerbjrn are you still looking for some better solutions that popular public repos or snippets as mentioned above ?

Did you review these: https://github.com/brwilkinson/ResourceModules#available-resource-modules ?