Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

Author: sbomer

xml/System.Diagnostics.CodeAnalysis/FeatureGuardAttribute.xml

@@ -30,12 +30,12 @@
   <Docs>
     <summary>
       <para>
-        Indicates that the specified public static boolean get-only property
+        Indicates that the specified public static Boolean read-only property
         guards access to the specified feature.</para>
     </summary>
     <remarks>
       <para>
-        Analyzers can use this to prevent warnings on calls to code that is
+        Analyzers can use this attribute to prevent warnings on calls to code that's
         annotated as requiring that feature, when the callsite is guarded by a
         call to the property.</para>
     </remarks>
@@ -55,7 +55,7 @@
       </code>
       When the app is built with `&lt;PublishAot&gt;true&lt;PublishAot&gt;`, the call to
       `Feature.Implementation()` doesn't produce analyzer warning
-      <see href="https://learn.microsoft.com/en-us/dotnet/core/deploying/native-aot/warnings/il3050">IL3050</see>,
+      <see href="/dotnet/core/deploying/native-aot/warnings/il3050">IL3050</see>,
       and `Feature.Implementation` code is removed when publishing.
     </example>
   </Docs>

xml/System.Diagnostics.CodeAnalysis/FeatureSwitchDefinitionAttribute.xml

@@ -30,12 +30,12 @@
   <Docs>
     <summary>
       <para>
-        Indicates that the specified public static boolean get-only property
+        Indicates that the specified public static Boolean read-only property
         corresponds to the feature switch specified by name.</para>
     </summary>
     <remarks>
       <para>
-        IL rewriters and compilers can use this to substitute the return value
+        IL rewriters and compilers can use this attribute to substitute the return value
         of the specified property with the value of the feature switch.</para>
     </remarks>
     <example>