Merge branch 'main' into NullableArrRollback

src/OpenTelemetry.Instrumentation.AspNetCore/README.md

@@ -86,7 +86,7 @@ services.AddOpenTelemetryTracing(
 It is important to note that this `Filter` option is specific to this
 instrumentation. OpenTelemetry has a concept of a
 [Sampler](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/trace/sdk.md#sampling),
-and the `Filter` option does the filtering *before* the Sampler is invoked.
+and the `Filter` option does the filtering *after* the Sampler is invoked.
 
 ### Enrich
 

src/OpenTelemetry/Trace/SamplingParameters.cs

@@ -71,10 +71,15 @@ public SamplingParameters(
         /// <summary>
         /// Gets the kind of span/activity to be created.
         /// </summary>
+        /// <remarks>
+        /// For Activities created outside of ActivitySource,
+        /// the Kind will be the default (Internal).
+        /// </remarks>
         public ActivityKind Kind { get; }
 
         /// <summary>
         /// Gets the tags to be associated to the span/activity to be created.
+        /// These are the tags provided at the time of Activity creation.
         /// </summary>
         public IEnumerable<KeyValuePair<string, object>> Tags { get; }