How to attach @doc() to an @useAuth() Model?

[charlypoly]

Hi 👋🏼

I've been trying to get the followingsecuritySchemes with description with Typespec:

{
  "securitySchemes": {
    "bearerAuth": {
      "type": "apiKey",
      "in": "header",
      "name": "x-my-key",
      "description": "A custom explanation on API Key"
    }
  }
}

Adding a @doc(...) on the line before useAuth(...) doesn't seem to do the trick.
Looking at the implementation, it should be possible to attach a description to a security scheme by using @doc():

typespec/packages/http/src/decorators.ts

Line 610 in 69d6cb7

const description = getDoc(program, modelType);

However, I did not find how to properly apply the @doc() to get it attached to the Model. Am I missing something, or is it a bug?

[timotheeguerin]

If you create a custom model for your authentication you can do that playground example

import "@typespec/http";

using TypeSpec.Http;

/** Some custom doc */
model MyAuth is BasicAuth {

}
@service
@useAuth(MyAuth)
namespace DemoService { 
}

[charlypoly]

Works! Thank you for the quick answer ⚡