.NET Standard TOC: combined parallel programming topics (#4887)

* .NET standard TOC: combined parallel programming topics

* Feedback

Author: pkulikov

docs/framework/development-guide.md

@@ -44,7 +44,7 @@ This section explains how to create, configure, debug, secure, and deploy your .
  [Windows Service Applications](../../docs/framework/windows-services/index.md)  
  Explains how you can use Visual Studio and the .NET Framework to create an app that is installed as a service, and start, stop, and otherwise control its behavior.  
 
- [Parallel Processing and Concurrency](../../docs/standard/parallel-processing-and-concurrency.md)  
+ [Parallel Processing, Concurrency, and Async Programming in .NET](../../docs/standard/parallel-processing-and-concurrency.md)  
  Provides information about managed threading, parallel programming, and asynchronous programming design patterns.  
 
  [Network Programming in the .NET Framework](../../docs/framework/network-programming/index.md)  

docs/standard/async.md

@@ -37,4 +37,14 @@ Async code has the following characteristics:
 
 ## What's next?
 
-For a deep dive into async concepts and programming, see [Async in depth](async-in-depth.md) and [Task-based asynchronous programming](~/docs/standard/parallel-programming/task-based-asynchronous-programming.md).
+For more information, see the [Async in depth](async-in-depth.md) topic.
+
+The [Asynchronous Programming Patterns](/asynchronous-programming-patterns/index.md) topic provides an overview of the three asynchronous programming patterns supported in .NET:  
+  
+-   [Asynchronous Programming Model (APM)](asynchronous-programming-patterns/asynchronous-programming-model-apm.md) (legacy)  
+  
+-   [Event-based Asynchronous Pattern (EAP)](asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md) (legacy)  
+  
+-   [Task-based Asynchronous Pattern (TAP)](asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md) (recommended for new development)  
+
+For more information about recommended task-based programming model, see the [Task-based asynchronous programming](parallel-programming/task-based-asynchronous-programming.md) topic.

docs/standard/parallel-processing-and-concurrency.md

@@ -1,18 +1,14 @@
 ---
-title: "Parallel Processing and Concurrency in the .NET Framework"
-ms.custom: ""
-ms.date: "03/30/2017"
+title: "Parallel Processing, Concurrency, and Async Programming in .NET"
+description: "Learn how to make your application more responsive and faster with .NET capabilities for parallel processing and asynchronous programming"
+ms.date: "04/06/2018"
 ms.prod: ".net"
-ms.reviewer: ""
-ms.suite: ""
 ms.technology: dotnet-standard
-ms.tgt_pltfrm: ""
 ms.topic: "article"
 helpviewer_keywords: 
-  - ".NET Framework, parallel processing"
-  - "parallel processing [.NET Framework]"
-  - "concurrency [.NET Framework]"
-  - ".NET Framework, concurrency"
+  - "parallel processing [.NET]"
+  - "concurrency [.NET]"
+  - "asynchronous programming [.NET]"
 ms.assetid: e573faa8-0212-44b1-a850-ce85dc54f47f
 caps.latest.revision: 7
 author: "rpetrusha"
@@ -22,24 +18,15 @@ ms.workload:
   - "dotnet"
   - "dotnetcore"
 ---
-# Parallel Processing and Concurrency in the .NET Framework
-The .NET Framework provides several ways for you to use multiple threads of execution to keep your application responsive to your user while maximizing the performance of your user's computer.  
+# Parallel Processing, Concurrency, and Async Programming in .NET
+.NET provides several ways for you to write asynchronous code to make your application more responsive to a user and write parallel code that uses multiple threads of execution to maximize the performance of your user's computer.  
 
 ## In This Section  
- [Threading](../../docs/standard/threading/index.md)  
- Describes the basic concurrency and synchronization mechanisms provided by the .NET Framework.  
-  
- [Asynchronous Programming Patterns](../../docs/standard/asynchronous-programming-patterns/index.md)  
- Provides a brief overview of the three asynchronous programming patterns supported in the .NET Framework:  
-  
--   [Asynchronous Programming Model (APM)](../../docs/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm.md) (legacy)  
-  
--   [Event-based Asynchronous Pattern (EAP)](../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md) (legacy)  
-  
--   [Task-based Asynchronous Pattern (TAP)](../../docs/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md) (recommended for new development)  
+ [Asynchronous Programming](../../docs/standard/async.md)  
+ Describes mechanisms for asynchronous programming provided by .NET.  
 
  [Parallel Programming](../../docs/standard/parallel-programming/index.md)  
  Describes a task-based programming model that simplifies parallel development, enabling you to write efficient, fine-grained, and scalable parallel code in a natural idiom without having to work directly with threads or the thread pool.  
-  
-## See Also  
- [Development Guide](../../docs/framework/development-guide.md)
+
+ [Threading](../../docs/standard/threading/index.md)  
+ Describes the basic concurrency and synchronization mechanisms provided by .NET.  

docs/standard/threading/index.md

@@ -56,8 +56,8 @@ Whether you are developing for computers with one processor or several, you want
  [Asynchronous File I/O](../../../docs/standard/io/asynchronous-file-i-o.md)  
  Describes the performance advantages and basic operation of asynchronous I/O.  
 
- [Event-based Asynchronous Pattern (EAP)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)  
- Provides an overview of asynchronous programming.  
+ [Task-based Asynchronous Pattern (TAP)](../../../docs/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md)  
+ Provides an overview of the recommended pattern for asynchronous programming in .NET.  
 
  [Calling Synchronous Methods Asynchronously](../../../docs/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously.md)  
  Explains how to call methods on thread pool threads using built-in features of delegates.  

docs/toc.md

@@ -35,9 +35,12 @@
 ## [Delegates and lambdas](standard/delegates-lambdas.md)
 ## [LINQ](standard/using-linq.md)
 ## [Common Type System & Common Language Specification](standard/common-type-system.md)
-## [Asynchronous programming](standard/async.md)
-### [Asynchronous programming in depth](standard/async-in-depth.md)
-### [Asynchronous Programming Patterns](standard/asynchronous-programming-patterns/)
+## [Parallel Processing, Concurrency, and Async](standard/parallel-processing-and-concurrency.md)
+### [Asynchronous programming](standard/async.md)
+#### [Asynchronous programming in depth](standard/async-in-depth.md)
+#### [Asynchronous Programming Patterns](standard/asynchronous-programming-patterns/)
+### [Parallel Programming](standard/parallel-programming/)
+### [Threading](standard/threading/)
 ## [Native interoperability](standard/native-interop.md)
 ## [Collections and Data Structures](standard/collections/)
 ## [Numerics in .NET](standard/numerics.md)
@@ -46,15 +49,12 @@
 ## [Managed Execution Process](standard/managed-execution-process.md)
 ## [Metadata and Self-Describing Components](standard/metadata-and-self-describing-components.md)
 ## [Building Console Applications](standard/building-console-apps.md)
-## [Parallel Processing and Concurrency](standard/parallel-processing-and-concurrency.md)
 ## [Application Essentials](standard/application-essentials.md)
 ## [File and Stream I/O](standard/io/index.md)
 ## [Globalization and Localization](standard/globalization-localization/)
 ## [Attributes](standard/attributes/)
 ## [Framework Design Guidelines](standard/design-guidelines/)
 ## [XML Documents and Data](standard/data/xml/)
-## [Threading](standard/threading/)
-## [Parallel Programming](standard/parallel-programming/)
 ## [Security](standard/security/)
 ## [Serialization](standard/serialization/)
 ## [Developing for Multiple Platforms](standard/cross-platform/)