Describe the bug
deployment reference documentation
does NOT contain any information about resource naming constrains. IMO deployment reference should contain most or even all information that is needed to use given resource. As far as I know key vault documentation does not mention usage of this resource type(Microsoft.KeyVault/vaults/accessPolicies ) at all.

REST API states following:

Luckily VS code manages to display an error when non-working name is being used:

The results:

Looks like deployment reference documentation drops all information about name constraining.

How much naming-related documentation is missing from deployment reference documention?
How common is this issue on other resources?
Where to report naming issues?

• e.g. portal requires some hard-coded naming but REST API spec does not mention it

Luckily, at least in this case, intellisense helps users to write working Bicep files and makes the issue less important to be fixed.

Minor related issue(will be splitted on its own ticket):

• REST API does not describe operation names. To find out if add supports upsert, user needs to read through examples and maybe even test if given operations are idempotent or not.