From 2b82166df65b897e08751df76441c7c62d57197d Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 2 Apr 2026 17:49:09 +0000
Subject: [PATCH 1/2] Initial plan


From 43ce8b5594e54572c97cfc7b15d6fba0c535139c Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 2 Apr 2026 18:25:19 +0000
Subject: [PATCH 2/2] Add cryptographic security NOTE to System.Random
 type-level remarks

Agent-Logs-Url: https://github.com/dotnet/dotnet-api-docs/sessions/864bf564-cbba-4176-b4fa-a901073a6b7c

Co-authored-by: GrabYourPitchforks <1746272+GrabYourPitchforks@users.noreply.github.com>
---
 xml/System/Random.xml | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/xml/System/Random.xml b/xml/System/Random.xml
index 266ebac38f1..4cfe623731b 100644
--- a/xml/System/Random.xml
+++ b/xml/System/Random.xml
@@ -74,7 +74,14 @@
   </Attributes>
   <Docs>
     <summary>Represents a pseudo-random number generator, which is an algorithm that produces a sequence of numbers that meet certain statistical requirements for randomness.</summary>
-    <remarks>For more information about this API, see <see href="/dotnet/fundamentals/runtime-libraries/system-random">Supplemental API remarks for Random</see>.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+> [!NOTE]
+> To generate a cryptographically secure random number, such as one that's suitable for creating a random password, use one of the static methods in the <xref:System.Security.Cryptography.RandomNumberGenerator> class.
+
+For more information about this API, see [Supplemental API remarks for Random](/dotnet/fundamentals/runtime-libraries/system-random).
+      ]]></format>
+    </remarks>
     <example>
       <format type="text/markdown"><![CDATA[
 The following example creates a single random number generator and calls its <xref:System.Random.NextBytes*>, <xref:System.Random.Next*>, and <xref:System.Random.NextDouble*> methods to generate sequences of random numbers within different ranges.