@Deprecated tag doesn't handle code snippet arguments

[tcNickolas]

Looking at the source of this page https://github.com/microsoft/QuantumLibraries/blob/8352240cf512dc46824f38354102282bd7925cf7/Standard/src/Arithmetic/Deprecated.qs#L143 The argument to @Deprecated is not a fully qualified operation name but rather a code snippet, but the documentation attempts to treat it as an operation name by appending xref: to it. It would be nice if the documentation generator could distinguish this scenario (maybe by presence of characters other than letters and dots?) and generate a better "use instead" suggestion.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 12e1eea8-8a33-f46b-dd1e-47d616baa9e5
• Version Independent ID: f3eaf09f-b6ee-ed12-3ece-5cbaada9fff1
• Content: InPlaceXorBE operation - Q# reference - Microsoft Quantum
• Content Source: api/qsharp/microsoft.quantum.canon.inplacexorbe.md
• Product: qsharp
• GitHub Login: @ricardo-espinoza

[cgranade]

Thanks for filing this, @tcNickolas. The @Deprecated attribute is defined in the packages built from the qsharp-runtime repo, so I'll go on and transfer the issue there.