update rid text

dotnet · Sep 6, 2023 · 85d7eda · 85d7eda
1 parent a47a877
commit 85d7eda
Showing 1 changed file with 7 additions and 5 deletions.
diff --git a/xml/System.Runtime.InteropServices/RuntimeInformation.xml b/xml/System.Runtime.InteropServices/RuntimeInformation.xml
@@ -205,7 +205,7 @@ The property returns a string that indicates the name of the currently executing
 
 ## Remarks
 
-The returned value is intended to represent the actual architecture of the underlying operating system. It is a best effort to ignore the architecture emulation infrastructure that may be involved to run the process. The returned value takes into account emulation built into Windows and macOS operating systems. The returned value does not take into account emulation using QEMU that is typically used on Linux operating system. 
+The returned value is intended to represent the actual architecture of the underlying operating system. It is a best effort to ignore the architecture emulation infrastructure that may be involved to run the process. The returned value takes into account emulation built into Windows and macOS operating systems. The returned value does not take into account emulation using QEMU that is typically used on Linux operating system.
 
  ]]></format>
         </remarks>
@@ -340,18 +340,20 @@ It's not recommended to parse the string for information.
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets the platform on which an app is running.</summary>
-        <value>An opaque string that identifies the platform on which the app is running.</value>
+        <summary>Gets the platform for which the runtime was built (or on which an app is running).</summary>
+        <value>An opaque string that identifies the platform for which the runtime was built (or on which an app is running).</value>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
 
-This property returns a string that identifies the operating system, typically including the version and processor architecture of the currently executing process.
+.NET 8 and later versions: This property returns a string that identifies the operating system and processor architecture for which the runtime was built. For example, the value on Windows 11 is `win-x64`, and on Ubuntu 20.04, it's `linux-x64`.
+
+.NET 7 and earlier versions: This property returns a string that identifies the platform (operating system, version, and processor architecture) on which the current process is running. For example, when running an application on Windows 11, the value is `win10-x64`, and on Ubuntu 20.04, it can be `ubuntu.20.04-x64`.
 
 Since this string is opaque, it's not recommended to parse the string into its constituent parts.
 
-For more information, see [.NET Core RID catalog](/dotnet/core/rid-catalog).
+For more information, see [.NET RID catalog](/dotnet/core/rid-catalog).
 
           ]]></format>
         </remarks>