Add docs for SYSLIB5003

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

@@ -21,7 +21,7 @@ The following table provides an index to the `SYSLIB5XXX` experimental APIs in .
 | - | - | - |
 | SYSLIB5001 | .NET 9 | <xref:System.Numerics.Tensors.Tensor%601> and related APIs in <xref:System.Numerics.Tensors> are experimental |
 | SYSLIB5002 | .NET 9 | <xref:System.Drawing.SystemColors> alternate colors are experimental |
-| SYSLIB5003 | .NET 9 | <xref:System.Runtime.Intrinsics.Arm.Sve> is experimental |
+| [SYSLIB5003](./syslib5003.md) | .NET 9 | <xref:System.Runtime.Intrinsics.Arm.Sve> is experimental |
 | SYSLIB5004 | .NET 9 | <xref:System.Runtime.Intrinsics.X86.X86Base.DivRem(System.UInt32,System.Int32,System.Int32)> is experimental since performance is not as optimized as `T.DivRem` |
 | SYSLIB5005 | .NET 9 | <xref:System.Formats.Nrbf> is experimental |
 

docs/fundamentals/syslib-diagnostics/syslib5003.md

@@ -0,0 +1,25 @@
+---
+title: SYSLIB5003 warning
+description: Learn about the diagnostic that generates compile-time warning SYSLIB5003.
+ms.date: 11/01/2024
+f1_keywords:
+  - syslib5003
+---
+
+# SYSLIB5003: SVE is a preview feature can be used by enabling EnablePreviewFeatures flag
+
+In .NET 9, the first set of non-streaming SVE APIs were introduced and annotated with the <xref:System.Diagnostics.CodeAnalysis.ExperimentalAttribute>. This attribute indicates that both the internal implementation and the generated code for SVE might undergo changes. These potential changes include modifications to method signatures, parameters, or namespaces in future updates, aimed at ensuring robust support for upcoming SVE technologies and streaming SVE designs. If you're using these APIs in your project, you'll need to suppress the `SYSLIB5003` diagnostic.
+
+To suppress the warnings in a project file:
+
+```xml
+<PropertyGroup>
+   <!-- SYSLIB50003: System.Runtime.Intrinsics.Arm.Sve is experimental -->
+   <NoWarn>$(NoWarn);SYSLIB5003</NoWarn>
+</PropertyGroup>
+```
+
+## See also
+
+- [Experimental features](experimental-overview.md)
+- [Future work](https://devblogs.microsoft.com/dotnet/engineering-sve-in-dotnet/#8.-future)

docs/navigate/tools-diagnostics/toc.yml

@@ -1809,6 +1809,9 @@ items:
           - name: Overview
             displayName: syslib, experimental
             href: ../../fundamentals/syslib-diagnostics/experimental-overview.md
+          - name: SYSLIB5003
+            href: ../../fundamentals/syslib-diagnostics/syslib5003.md
+            displayProperty: syslib5003          
       - name: Source-generated code
         items:
           - name: Overview