diff --git a/xml/System.Reflection.Metadata/MetadataUpdateHandlerAttribute.xml b/xml/System.Reflection.Metadata/MetadataUpdateHandlerAttribute.xml
index bc0a934528a..9e27664faac 100644
--- a/xml/System.Reflection.Metadata/MetadataUpdateHandlerAttribute.xml
+++ b/xml/System.Reflection.Metadata/MetadataUpdateHandlerAttribute.xml
@@ -20,8 +20,20 @@
- To be added.
- To be added.
+ Indicates that a type that should receive notifications of metadata updates.
+
+ specified by this attribute should implement static methods matching the signature of one or more of the following (visibility of the methods does not matter):
+ - `static void ClearCache(Type[]? updatedTypes)`
+ - `static void UpdateApplication(Type[]? updatedTypes)`
+
+After a metadata update is applied, `ClearCache` is invoked for every handler that specifies one. This gives update handlers an opportunity to clear any caches that are inferred based on the application's metadata. After all `ClearCache` methods have been invoked, `UpdateApplication` is invoked for every handler that specifies one. This enables applications to refresh the application state, trigger a UI re-render, or other such reactions. When specified, the `updatedTypes` parameter contains the set of types that were affected by the metadata update; if it's `null`, any type may have been updated.
+
+ ]]>
+
@@ -47,8 +59,8 @@
- To be added.
- To be added.
+ A type that handles metadata updates and that should be notified when any occur.
+ Initializes the attribute.
To be added.
@@ -74,7 +86,7 @@
System.Type
- To be added.
+ Gets the type that handles metadata updates and that should be notified when any occur.
To be added.
To be added.
diff --git a/xml/System.Reflection.Metadata/MetadataUpdater.xml b/xml/System.Reflection.Metadata/MetadataUpdater.xml
index 0a83755e1b8..73547ecd942 100644
--- a/xml/System.Reflection.Metadata/MetadataUpdater.xml
+++ b/xml/System.Reflection.Metadata/MetadataUpdater.xml
@@ -40,12 +40,24 @@
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The assembly to update.
+ The metadata changes to be applied.
+ The IL changes to be applied.
+ The PDB changes to be applied.
+ Updates the specified assembly using the provided metadata, IL, and PDB deltas.
+
+
+
+ The assembly argument is not a runtime assembly.
+ The assembly argument is .
+ The assembly is not editable.
+ The update could not be applied.
@@ -64,8 +76,8 @@
System.Boolean
- To be added.
- To be added.
+ Gets a value that indicates whether the assembly update is enabled and available.
+ if the assembly update is enabled and available; otherwise, .
To be added.
diff --git a/xml/System.Reflection/NullabilityInfo.xml b/xml/System.Reflection/NullabilityInfo.xml
index 280366e2ebb..8558d480923 100644
--- a/xml/System.Reflection/NullabilityInfo.xml
+++ b/xml/System.Reflection/NullabilityInfo.xml
@@ -14,7 +14,7 @@
- To be added.
+ Represents nullability information.
To be added.
@@ -34,8 +34,8 @@
System.Reflection.NullabilityInfo
- To be added.
- To be added.
+ Gets the nullability information for the element type of the array.
+ If the member type is an array, the of the elements of the array; otherwise, .
To be added.
@@ -55,8 +55,8 @@
System.Reflection.NullabilityInfo[]
- To be added.
- To be added.
+ Gets the nullability information for each type parameter.
+ If the member type is a generic type, the nullability information for each type parameter.
To be added.
@@ -76,7 +76,7 @@
System.Reflection.NullabilityState
- To be added.
+ Gets the nullability read state of the member.
To be added.
To be added.
@@ -97,7 +97,7 @@
System.Type
- To be added.
+ Gets the type of the member or generic parameter to which this instance belongs.
To be added.
To be added.
@@ -118,7 +118,7 @@
System.Reflection.NullabilityState
- To be added.
+ Gets the nullability write state of the member.
To be added.
To be added.
diff --git a/xml/System.Reflection/NullabilityInfoContext.xml b/xml/System.Reflection/NullabilityInfoContext.xml
index bdbefb1fb1d..b885f993b95 100644
--- a/xml/System.Reflection/NullabilityInfoContext.xml
+++ b/xml/System.Reflection/NullabilityInfoContext.xml
@@ -14,7 +14,7 @@
- To be added.
+ Provides APIs for populating nullability information and context from reflection members: , , , and .
To be added.
@@ -31,7 +31,7 @@
- To be added.
+ Initializes a new instance of the class.
To be added.
@@ -54,10 +54,12 @@
- To be added.
- To be added.
- To be added.
+ The event for which to populate nullability information.
+ Populates a for the given . If the nullablePublicOnly feature is set for an assembly, like it does in the .NET SDK, the private and/or internal member's nullability attributes are omitted, and the API will return the state.
+ A instance.
To be added.
+
+ is .
@@ -79,10 +81,12 @@
- To be added.
- To be added.
- To be added.
+ The field for which to populate the nullability information.
+ Populates a for the given . If the nullablePublicOnly feature is set for an assembly, like it does in the .NET SDK, the private and/or internal member's nullability attributes are omitted, and the API will return the state.
+ A instance.
To be added.
+
+ is .
@@ -104,10 +108,12 @@
- To be added.
- To be added.
- To be added.
+ The parameter for which to populate the nullability information.
+ Populates a for the given . If the nullablePublicOnly feature is set for an assembly, like it does in the .NET SDK, the private and/or internal member's nullability attributes are omitted, and the API will return the state.
+ A instance.
To be added.
+
+ is .
@@ -129,10 +135,12 @@
- To be added.
- To be added.
- To be added.
+ The property for which to populate the nullability information.
+ Populates a for the given . If the nullablePublicOnly feature is set for an assembly, like it does in the .NET SDK, the private and/or internal member's nullability attributes are omitted, and the API will return the state.
+ A instance.
To be added.
+
+ is .
diff --git a/xml/System.Reflection/NullabilityState.xml b/xml/System.Reflection/NullabilityState.xml
index 7da1d89c239..83a1e9bcde1 100644
--- a/xml/System.Reflection/NullabilityState.xml
+++ b/xml/System.Reflection/NullabilityState.xml
@@ -13,7 +13,7 @@
System.Enum
- To be added.
+ Describes nullability states.
To be added.
@@ -34,7 +34,7 @@
1
- To be added.
+ Non-nullable value or reference type.
@@ -54,7 +54,7 @@
2
- To be added.
+ Nullable value or reference type.
@@ -74,7 +74,7 @@
0
- To be added.
+ Nullability context not enabled (oblivious).