Preferred way to specify parameters?

[larryclaman]

The documentation for parameters at docs/spec/parameters.md specifies that properties of a parameter are specified within brackets; eg

param storageAccountName string {
  minLength: 3
  maxLength: 24
}

But in the tutorial docs/tutorial/01-simple-template.md, it suggests using @ decorators:

@minLength(3)
@maxLength(24)
param name string = 'uniquestorage001' // must be globally unique

Is either of these formats preferred over the other?

(Also, a request that the alternate '@' syntax be documented in the appropriate docs/spec/* files (I might have missed it, but I couldn't find it documented in any of the spec files)

[anthony-c-martin]

Thanks for pointing this out! The 0.3 release of Bicep introduced decorators - the @ syntax you're seeing in the tutorial.

We will be deprecating the old syntax in 0.4 (#1670), but have left both syntaxes in-place for 0.3 to avoid breaking existing users. So @ is definitely the preferred syntax. I've added #1727 to ensure we update our documentation.