Fixup RandomNumberGenerator (#8023)

Author: vcsjones

xml/System.Security.Cryptography/RandomNumberGenerator.xml

@@ -58,13 +58,15 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>Represents the abstract class from which all implementations of cryptographic random number generators derive.</summary>
+    <summary>Provides functionality for generating random values.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
 Cryptographic random number generators create cryptographically strong random values.
 
+Using the static members of this class is the preferred way to generate random values.
+
 To create a random number generator, call the @System.Security.Cryptography.RandomNumberGenerator.Create method. This is preferred over calling the constructor of the derived class @System.Security.Cryptography.RNGCryptoServiceProvider, which is not available on all platforms.
  ]]></format>
     </remarks>
@@ -113,11 +115,11 @@ To create a random number generator, call the @System.Security.Cryptography.Rand
       <Docs>
         <summary>Initializes a new instance of <see cref="T:System.Security.Cryptography.RandomNumberGenerator" />.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- You cannot create an instance of an abstract class. Application code will create a new instance of a derived class. For an implementation of a cryptographic random number generator, use the derived class <xref:System.Security.Cryptography.RNGCryptoServiceProvider>.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ You cannot create an instance of an abstract class. Application code will create a new instance of a derived class. For an implementation of a cryptographic random number generator, use the derived class <xref:System.Security.Cryptography.RNGCryptoServiceProvider>.
+
  ]]></format>
         </remarks>
         <related type="Article" href="/dotnet/standard/security/cryptographic-services">Cryptographic Services</related>
@@ -303,16 +305,16 @@ To create a random number generator, call the @System.Security.Cryptography.Rand
       <Docs>
         <summary>When overridden in a derived class, releases all resources used by the current instance of the <see cref="T:System.Security.Cryptography.RandomNumberGenerator" /> class.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Call `Dispose` when you are finished using the <xref:System.Security.Cryptography.RandomNumberGenerator>. The `Dispose` method leaves the <xref:System.Security.Cryptography.RandomNumberGenerator> in an unusable state. After calling `Dispose`, you must release all references to the <xref:System.Security.Cryptography.RandomNumberGenerator> so the garbage collector can reclaim the memory that the <xref:System.Security.Cryptography.RandomNumberGenerator> was occupying.  
-  
- For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged) and [Implementing a Dispose Method](/dotnet/standard/garbage-collection/implementing-dispose).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Call `Dispose` when you are finished using the <xref:System.Security.Cryptography.RandomNumberGenerator>. The `Dispose` method leaves the <xref:System.Security.Cryptography.RandomNumberGenerator> in an unusable state. After calling `Dispose`, you must release all references to the <xref:System.Security.Cryptography.RandomNumberGenerator> so the garbage collector can reclaim the memory that the <xref:System.Security.Cryptography.RandomNumberGenerator> was occupying.
+
+ For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged) and [Implementing a Dispose Method](/dotnet/standard/garbage-collection/implementing-dispose).
+
 > [!NOTE]
->  Always call `Dispose` before you release your last reference to the <xref:System.Security.Cryptography.RandomNumberGenerator>. Otherwise, the resources it is using will not be freed until the garbage collector calls the <xref:System.Security.Cryptography.RandomNumberGenerator> object's `Finalize` method.  
-  
+>  Always call `Dispose` before you release your last reference to the <xref:System.Security.Cryptography.RandomNumberGenerator>. Otherwise, the resources it is using will not be freed until the garbage collector calls the <xref:System.Security.Cryptography.RandomNumberGenerator> object's `Finalize` method.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -361,19 +363,19 @@ To create a random number generator, call the @System.Security.Cryptography.Rand
           <see langword="true" /> to release both managed and unmanaged resources; <see langword="false" /> to release only unmanaged resources.</param>
         <summary>When overridden in a derived class, releases the unmanaged resources used by the <see cref="T:System.Security.Cryptography.RandomNumberGenerator" /> and optionally releases the managed resources.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- This method is called by the public `Dispose()` method and the `Finalize` method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.  
-  
- When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this <xref:System.Security.Cryptography.RandomNumberGenerator> references. This method invokes the `Dispose()` method of each referenced object.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ This method is called by the public `Dispose()` method and the `Finalize` method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
+
+ When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this <xref:System.Security.Cryptography.RandomNumberGenerator> references. This method invokes the `Dispose()` method of each referenced object.
+
  ]]></format>
         </remarks>
         <block subset="none" type="overrides">
           <para>
-            <see langword="Dispose" /> can be called multiple times by other objects. When overriding <see langword="Dispose(Boolean)" />, be careful not to reference objects that have been previously disposed in an earlier call to <see langword="Dispose" />. For more information about how to implement <see langword="Dispose(Boolean)" />, see [Implementing a Dispose Method](/dotnet/standard/garbage-collection/implementing-dispose).  
-  
+            <see langword="Dispose" /> can be called multiple times by other objects. When overriding <see langword="Dispose(Boolean)" />, be careful not to reference objects that have been previously disposed in an earlier call to <see langword="Dispose" />. For more information about how to implement <see langword="Dispose(Boolean)" />, see [Implementing a Dispose Method](/dotnet/standard/garbage-collection/implementing-dispose).
+
  For more information about <see langword="Dispose" /> and <see langword="Finalize" />, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged).</para>
         </block>
         <related type="Article" href="/dotnet/standard/security/cryptographic-services">Cryptographic Services</related>
@@ -471,18 +473,18 @@ To create a random number generator, call the @System.Security.Cryptography.Rand
         <param name="data">The array to fill with cryptographically strong random bytes.</param>
         <summary>When overridden in a derived class, fills an array of bytes with a cryptographically strong random sequence of values.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
  The length of the byte array determines how many random bytes are produced.
-  
-## Examples  
- The following example creates a random sequence 100 bytes long and stores it in `random`.  
-  
+
+## Examples
+ The following example creates a random sequence 100 bytes long and stores it in `random`.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_Classic/classic RandomNumberGenerator.GetBytes Example/CPP/source.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/RandomNumberGenerator/GetBytes/source.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_Classic/classic RandomNumberGenerator.GetBytes Example/VB/source.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_Classic/classic RandomNumberGenerator.GetBytes Example/VB/source.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <related type="Article" href="/dotnet/standard/security/cryptographic-services">Cryptographic Services</related>
@@ -648,15 +650,15 @@ To create a random number generator, call the @System.Security.Cryptography.Rand
         <summary>Generates a random integer between 0 (inclusive) and a specified exclusive upper bound using a cryptographically strong random number generator.</summary>
         <returns>A random integer between 0 (inclusive) and <paramref name="toExclusive" /> (exclusive).</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
  The upper bound is exclusive to enable passing in a length value from an array, span, or list.
  Because it is an exclusive upper bound this method can never generate <xref:System.Int32.MaxValue?displayProperty=nameWithType>.
 
  This method uses a discard-and-retry strategy to avoid the low value bias that a simple modular arithmetic operation would produce.
-  
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="toExclusive" /> parameter is less than or equal to 0.</exception>
@@ -698,17 +700,17 @@ To create a random number generator, call the @System.Security.Cryptography.Rand
         <summary>Generates a random integer between a specified inclusive lower bound and a specified exclusive upper bound using a cryptographically strong random number generator.</summary>
         <returns>A random integer between <paramref name="fromInclusive" /> (inclusive) and <paramref name="toExclusive" /> (exclusive).</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
  The upper bound is exclusive to enable passing in a length value from an array, span, or list.
  Because it is an exclusive upper bound this method can never generate <xref:System.Int32.MaxValue?displayProperty=nameWithType>.
 
  This method uses a discard-and-retry strategy to avoid the low value bias that a simple modular arithmetic operation would produce.
 
  Negative values are permitted for both `fromInclusive` and `toExclusive`.
-  
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="toExclusive" /> parameter is less than or equal to the <paramref name="fromInclusive" /> parameter.</exception>
@@ -760,20 +762,20 @@ To create a random number generator, call the @System.Security.Cryptography.Rand
         <param name="data">The array to fill with cryptographically strong random nonzero bytes.</param>
         <summary>When overridden in a derived class, fills an array of bytes with a cryptographically strong random sequence of nonzero values.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The length of the byte array determines how many random bytes are produced.  
-  
-   
-  
-## Examples  
- The following example creates a random sequence of 100 nonzero bytes and stores it in `random`.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The length of the byte array determines how many random bytes are produced.
+
+
+
+## Examples
+ The following example creates a random sequence of 100 nonzero bytes and stores it in `random`.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_Classic/classic RandomNumberGenerator.GetNonZeroBytes Example/CPP/source.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/RandomNumberGenerator/GetNonZeroBytes/source.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_Classic/classic RandomNumberGenerator.GetNonZeroBytes Example/VB/source.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_Classic/classic RandomNumberGenerator.GetNonZeroBytes Example/VB/source.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <related type="Article" href="/dotnet/standard/security/cryptographic-services">Cryptographic Services</related>