[Bug]: Data plane sample in TypeSpec Azure playground should have descriptions on security schemes

[mikekistler]

Describe the bug

The OpenAPI for Azure services should have security schemes that include a description field, as this description is shown in the generated REST API documentation. Many service teams struggle to figure out how to add a description on the security scheme. The Data plane service example in the TypeSpec Azure playground currently does not illustrate how to do this:

Reproduction

Open the TypeSpec Azure playground and select the "Azure Core Data Plane Service" sample.

Checklist

• Follow our Code of Conduct
• Check that this issue is about the Azure libraries for typespec. For bug in the typespec language or core libraries file it in the TypeSpec repo
• Check that there isn't already an issue that request the same bug to avoid creating a duplicate.
• The provided reproduction is a minimal reproducible example of the bug.

[markcowl]

pri: 2

[copilot-swe-agent]

The agent encountered an error and was unable to start working on this issue: The service is temporarily unavailable. Please try again later. (Request id: FE89:100F64:6D1E12:9EA7C8:69E8FE2B)