Skip to content

Commit 14f48f2

Browse files
Apply feedback from review
Co-authored-by: Genevieve Warren <[email protected]>
1 parent baa0e3e commit 14f48f2

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

docs/fundamentals/syslib-diagnostics/experimental-overview.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,17 +7,17 @@ ms.date: 10/21/2024
77

88
# Experimental features in .NET 9+
99

10-
Starting in .NET 9, some features make use of the <xref:System.Diagnostics.CodeAnalysis.ExperimentalAttribute> to indicate that the API shape or functionality is included in the release but not yet officially supported. Experimental features offer the opportunity to collect feedback on the API shape and functionality with the intent of refining the APIs and removing the `[Experimental]` attribute in the next major release.
10+
Starting in .NET 9, some features make use of the <xref:System.Diagnostics.CodeAnalysis.ExperimentalAttribute> to indicate that the API shape or functionality is included in the release but not yet officially supported. Experimental features let the .NET team collect feedback on an API's shape and functionality with the intent of refining the API and removing the `[Experimental]` attribute in the next major release.
1111

12-
When an experimental API is referenced, the compiler will produce an error. Each feature that is marked as experimental has a unique diagnostic ID. To express consent to using them, you suppress the specific diagnostic. You can do that via any of the means for suppressing diagnostics, but the recommended way is to add the diagnostic to the project's `<NoWarn>` property. For more information, see [Suppress warnings](#suppress-warnings).
12+
When your code references an experimental API, the compiler produces an error with an ID like `SYSLIB5XXX`. Each feature that's marked as experimental has a unique diagnostic ID. To express consent to using an experimental feature, you suppress the specific diagnostic. You can do that via any of the means for suppressing diagnostics, but the recommended way is to add the diagnostic to the project's `<NoWarn>` property. For more information, see [Suppress warnings](#suppress-warnings).
1313

1414
Since each experimental feature has a separate ID, consenting to using one experimental feature doesn't consent to using another.
1515

1616
## Reference
1717

1818
The following table provides an index to the `SYSLIB5XXX` experimental APIs in .NET 9+.
1919

20-
| Diagnostic ID | Experimental Versions | Description |
20+
| Diagnostic ID | Experimental version | Description |
2121
| - | - | - |
2222
| SYSLIB5001 | .NET 9 | <xref:System.Numerics.Tensors.Tensor%601> and related APIs in <xref:System.Numerics.Tensors> are experimental |
2323
| SYSLIB5002 | .NET 9 | <xref:System.Drawing.SystemColors> alternate colors are experimental |
@@ -27,7 +27,7 @@ The following table provides an index to the `SYSLIB5XXX` experimental APIs in .
2727

2828
## Suppress warnings
2929

30-
Using an experimental feature offers the opportunity to submit feedback on the API shape and functionality before the feature is marked as stable and fully supported, but using the feature will produce a warning from the compiler. Suppressing the warning acknowledges that the API shape or functionality might change in the next major release. The warning can be suppressed through a `#pragma` directive in code or a `<NoWarn>` project setting.
30+
Using an experimental feature gives you the opportunity to submit feedback on the API shape and functionality before the feature is marked as stable and fully supported. But using the feature produces a warning from the compiler. When you suppress the warning, you acknowledge that the API shape or functionality might change in the next major release. The API might even be removed. You can suppress the warning through a `#pragma` directive in code or a `<NoWarn>` project setting.
3131

3232
To suppress the warnings in code:
3333

0 commit comments

Comments
 (0)