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
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.
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 appendingxref:
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.