From a7eb1576cdff9212fa3e02117ca9f63db00d4e16 Mon Sep 17 00:00:00 2001
From: Edward Brey <edward@breyfamily.net>
Date: Thu, 30 Aug 2018 20:11:49 -0500
Subject: [PATCH] Link to overview

The docs page for the Dataflow namespace links to the dataflow overview, but none of the class pages do. You can get from a class page to the overview in two steps, but you'd have to be lucky enough to guess that you should click on the namespace first. Until you do, you're left wondering what makes a BufferBlock different from an array, a queue, or any other "buffer for storing data".

The PR shows one way of making the overview more discoverable. The PR should be updated as needed to become the best way to provide the link and then expanded to cover all dataflow classes.
---
 xml/System.Threading.Tasks.Dataflow/BufferBlock`1.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/xml/System.Threading.Tasks.Dataflow/BufferBlock`1.xml b/xml/System.Threading.Tasks.Dataflow/BufferBlock`1.xml
index adad62b1318..3a8a11eb29e 100644
--- a/xml/System.Threading.Tasks.Dataflow/BufferBlock`1.xml
+++ b/xml/System.Threading.Tasks.Dataflow/BufferBlock`1.xml
@@ -42,7 +42,7 @@
   </Attributes>
   <Docs>
     <typeparam name="T">Specifies the type of the data buffered by this dataflow block.</typeparam>
-    <summary>Provides a buffer for storing data.</summary>
+    <summary>Provides a buffer for storing data for a <a href="https://docs.microsoft.com/en-us/dotnet/standard/parallel-programming/dataflow-task-parallel-library">Dataflow</a>.</summary>
     <remarks>
       <format type="text/markdown"><![CDATA[  
   
@@ -550,4 +550,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>