Cannot put metadata and doc to ResourceNameParameter

[pshao25]

Here is how I define a resource before:

model DataManagerForAgriculture extends TrackedResourceBase {
  /**
   * DataManagerForAgriculture resource name.
   */
  @maxLength(63)
  @minLength(1)
  @pattern("^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$")
  @path
  @key("dataManagerForAgricultureResourceName")
  @segment("farmBeats")
  @visibility("read")
  name: string;
}

I have customized document. I have length limitation by @maxLength and @minLength.

After I change it to

model DataManagerForAgriculture extends Foundations.TrackedResource {
  /**
   * DataManagerForAgriculture resource name.
   */
  ...ResourceNameParameter<
    DataManagerForAgriculture,
    "dataManagerForAgricultureResourceName",
    "farmBeats",
    "^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$"
  >;
}

The doc I added is ignored. And I cannot add more decorators to the spread ResourceNameParameter.

[markcowl]

@pshao25 You can do this using an augment decorator on the name parameter, as in this playground.

I think we should mention this in the docs, though.

[pshao25]

Thanks! Seems the link is wrong, but I already got your point! Augment decorator works!

My follow-up problem is the type of name in ResourceNameParameter is hard coded as string. What if the name is an enum? For this swagger, we previously defined its TypeSpec as

model Quota is ProxyResource<QuotaProperties> {
  /**
   * The quota name.
   */
  @path
  @key("name")
  @segment("quotas")
  @visibility("read")
  name: QuotaNames;
}

After I upgraded to the latest compiler, a non-string name is not allowed.

[markcowl]

est: 1
pri: 2

[pshao25]

@markcowl Just to confirm, your estimation is for the documentation or for the fix of enum name I put above? Do you want me to create a separate new issue for the enum name scenario?