diff --git a/xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml b/xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml
index cc51f6d2eee..649bfa10f40 100644
--- a/xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml
+++ b/xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml
@@ -37,7 +37,16 @@
           <see langword="out" /> parameters.</li>
       </ol>
       <para> This attribute is used in those instances where the <see langword="ref" /> should be allowed to escape.</para>
-      <para> Applying this attribute, in any form, has impact on consumers of the applicable API. It is necessary for API authors to understand the lifetime implications of applying this attribute and how it may impact their users.</para>
+      <para> Applying this attribute, in any form, has impact on consumers of the applicable API. It's necessary for API authors to understand the lifetime implications of applying this attribute and how it might impact their users.</para>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+This attribute is specially recognized by the runtime. ECMA-335 augment III.1.7.7 defines restrictions on valid IL that reference this attribute. For example, when this attribute is applied to an instance method of a value type, the `this` argument is allowed to escape the method. When the attribute is absent, an optimizing compiler can rely on `this` not escaping to further optimize certain code patterns, such as eliminating boxing. For more information, see the [ECMA-335 CLI Specification Addendum](https://github.com/dotnet/runtime/blob/main/docs/design/specs/Ecma-335-Augments.md#iii177-opt-in-restrictions), Sec. III.1.7.7 ("Opt-in restrictions").
+
+Because the runtime relies on this attribute, it can't be stripped from an assembly. The restrictions defined by augment III.1.7.7 apply only when the <xref:System.Runtime.CompilerServices.RefSafetyRulesAttribute> is present on the module, so this attribute has its documented effect only in a module that's also annotated with `RefSafetyRulesAttribute`.
+
+      ]]></format>
     </remarks>
   </Docs>
   <Members>
diff --git a/xml/System.Runtime.CompilerServices/RefSafetyRulesAttribute.xml b/xml/System.Runtime.CompilerServices/RefSafetyRulesAttribute.xml
index 48ded811b5d..279be7b1384 100644
--- a/xml/System.Runtime.CompilerServices/RefSafetyRulesAttribute.xml
+++ b/xml/System.Runtime.CompilerServices/RefSafetyRulesAttribute.xml
@@ -28,7 +28,17 @@
   </Attributes>
   <Docs>
     <summary>Indicates the language version of the ref safety rules used when the module was compiled.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+This attribute is specially recognized by the runtime. ECMA-335 augment III.1.7.7 defines restrictions on valid IL that reference this attribute. Applying this attribute to a module opts the module into further restrictions based on the version value specified in the attribute, which permits an optimizing compiler to further optimize certain code patterns. For more information, see the [ECMA-335 CLI Specification Addendum](https://github.com/dotnet/runtime/blob/main/docs/design/specs/Ecma-335-Augments.md#iii177-opt-in-restrictions), Sec. III.1.7.7 ("Opt-in restrictions").
+
+Because the runtime relies on this attribute, it can't be stripped from an assembly.
+
+      ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">