Feature (#189)

* Add xml comment

* fix: LocalSegment relationship error when use Task.WhenAll

build/common.props

-<Project>
+<Project>
   <Import Project="sign.props" />
   <Import Project="version.props" />
   <PropertyGroup>
@@ -16,5 +16,7 @@
     <GenerateAssemblyProductAttribute>True</GenerateAssemblyProductAttribute>
     <GeneratePackageOnBuild>False</GeneratePackageOnBuild>
     <PackageRequireLicenseAcceptance>True</PackageRequireLicenseAcceptance>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>1591</NoWarn>
   </PropertyGroup>
 </Project>

src/SkyApm.Abstractions/Tracing/Segments/SegmentSpan.cs

-/*
+/*
  * Licensed to the SkyAPM under one or more
  * contributor license agreements.  See the NOTICE file distributed with
  * this work for additional information regarding copyright ownership.
@@ -42,8 +42,8 @@ namespace SkyApm.Tracing.Segments
 
         public SpanLayer SpanLayer { get; set; }
 
+        /// <summary>Limiting values. Please see <see cref="Components" /> or see <seealso href="https://github.com/apache/incubator-skywalking/blob/master/oap-server/server-starter/src/main/resources/component-libraries.yml"/></summary>
         public StringOrIntValue Component { get; set; }
-
         public bool IsError { get; set; }
         public TagCollection Tags { get; } = new TagCollection();
 

src/SkyApm.Core/Tracing/LocalSegmentContextAccessor.cs

-/*
+/*
  * Licensed to the SkyAPM under one or more
  * contributor license agreements.  See the NOTICE file distributed with
  * this work for additional information regarding copyright ownership.
@@ -16,53 +16,32 @@
  *
  */
 
-using System.Collections.Concurrent;
-using System.Threading;
 using SkyApm.Tracing.Segments;
+using System.Runtime.CompilerServices;
+using System.Threading;
 
 namespace SkyApm.Tracing
 {
     public class LocalSegmentContextAccessor : ILocalSegmentContextAccessor
     {
-        private readonly AsyncLocal<ConcurrentStack<SegmentContext>> _segmentContextStack =
-            new AsyncLocal<ConcurrentStack<SegmentContext>>();
+        private readonly ConditionalWeakTable<SegmentContext, SegmentContext> _parent = new ConditionalWeakTable<SegmentContext, SegmentContext>();
+        private readonly AsyncLocal<SegmentContext> _segmentContext = new AsyncLocal<SegmentContext>();
 
         public SegmentContext Context
         {
-            get
-            {
-                var stack = _segmentContextStack.Value;
-                if (stack == null)
-                {
-                    return null;
-                }
-                stack.TryPeek(out var context);
-                return context;
-            }
+            get => _segmentContext.Value;
             set
             {
-                var stack = _segmentContextStack.Value;
-                if (stack == null)
-                {
-                    if (value == null) return;
-                    stack = new ConcurrentStack<SegmentContext>();
-                    stack.Push(value);
-                    _segmentContextStack.Value = stack;
-                }
-                else
-                {
+                var current = _segmentContext.Value;
                 if (value == null)
                 {
-                        stack.TryPop(out _);
-                        if (stack.IsEmpty)
-                        {
-                            _segmentContextStack.Value = null;
-                        }
+                    if (_parent.TryGetValue(current, out var parent))
+                        _segmentContext.Value = parent;
                 }
                 else
                 {
-                        stack.Push(value);
-                    }
+                    _parent.Add(value, current);
+                    _segmentContext.Value = value;
                 }
             }
         }