TOC changes for LINQ to XML section-part 4 (#12609)

BillWagner · web-flow · commit 996868042d9a · 2019-06-03T17:16:47.000-04:00
* first set: LINQ2XML for XPath users

* pure functional transforms section

* chaining queries tutorial

* respond to feedback.
diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json
@@ -756,6 +756,18 @@
             "source_path": "docs/csharp/programming-guide/concepts/linq/querying-xml-trees.md",
             "redirect_url": "/dotnet/csharp/programming-guide/concepts/linq/how-to-find-an-element-with-a-specific-attribute"
         },
+        {
+            "source_path": "docs/csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md",
+            "redirect_url": "/dotnet/csharp/programming-guide/concepts/linq/comparison-of-xpath-and-linq-to-xml"
+        },
+        {
+            "source_path": "docs/csharp/programming-guide/concepts/linq/pure-functional-transformations-of-xml.md",
+            "redirect_url": "/dotnet/csharp/programming-guide/concepts/linq/introduction-to-pure-functional-transformations"
+        },
+        {
+            "source_path": "docs/csharp/programming-guide/concepts/linq/tutorial-chaining-queries-together.md",
+            "redirect_url": "/dotnet/csharp/programming-guide/concepts/linq/deferred-execution-and-lazy-evaluation-in-linq-to-xml"
+        },
         {
             "source_path": "docs/csharp/programming-guide/concepts/threading/how-to-use-a-thread-pool.md",
             "redirect_url": "/dotnet/api/system.threading.threadpool.queueuserworkitem"
diff --git a/docs/csharp/programming-guide/concepts/linq/chaining-queries-example.md b/docs/csharp/programming-guide/concepts/linq/chaining-queries-example.md
@@ -82,4 +82,4 @@ Main: str >GHI!!!<
   
 ## See also
 
-- [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/tutorial-chaining-queries-together.md)
+- [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/deferred-execution-and-lazy-evaluation-in-linq-to-xml.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/chaining-standard-query-operators-together.md b/docs/csharp/programming-guide/concepts/linq/chaining-standard-query-operators-together.md
@@ -4,7 +4,7 @@ ms.date: 07/20/2015
 ms.assetid: 66f2b0a9-2c23-4735-988e-bbc9dfb55c7b
 ---
 # Chaining Standard Query Operators Together (C#)
-This is the final topic in the [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/tutorial-chaining-queries-together.md) tutorial.  
+This is the final topic in the [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/deferred-execution-and-lazy-evaluation-in-linq-to-xml.md) tutorial.  
   
  The standard query operators can also be chained together. For example, you can interject the <xref:System.Linq.Enumerable.Where%2A?displayProperty=nameWithType> operator, and it also operates in a lazy fashion. No intermediate results are materialized by it.  
   
@@ -79,7 +79,4 @@ ToUpper: source >ghi<
 AppendString: source >GHI<  
 Main: str >GHI!!!<  
 ```  
-  
-## See also
-
-- [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/tutorial-chaining-queries-together.md)
+  
diff --git a/docs/csharp/programming-guide/concepts/linq/comparison-of-xpath-and-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/comparison-of-xpath-and-linq-to-xml.md
@@ -97,7 +97,4 @@ customers.Elements("Customer").Elements("CompanyName")
 |preceding-sibling|<xref:System.Xml.Linq.XNode.ElementsBeforeSelf%2A?displayProperty=nameWithType><br /><br /> or<br /><br /> <xref:System.Xml.Linq.XNode.NodesBeforeSelf%2A?displayProperty=nameWithType>|  
 |following|No direct equivalent.|  
 |preceding|No direct equivalent.|  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
+  
diff --git a/docs/csharp/programming-guide/concepts/linq/deferred-execution-and-lazy-evaluation-in-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/deferred-execution-and-lazy-evaluation-in-linq-to-xml.md
@@ -29,7 +29,7 @@ Query and axis operations are often implemented to use deferred execution. This
   
 ## See also
 
-- [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/tutorial-chaining-queries-together.md)
+- [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/deferred-execution-and-lazy-evaluation-in-linq-to-xml.md)
 - [Concepts and Terminology (Functional Transformation) (C#)](../../../../csharp/programming-guide/concepts/linq/concepts-and-terminology-functional-transformation.md)
 - [Aggregation Operations (C#)](../../../../csharp/programming-guide/concepts/linq/aggregation-operations.md)
 - [yield](../../../../csharp/language-reference/keywords/yield.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/deferred-execution-example.md b/docs/csharp/programming-guide/concepts/linq/deferred-execution-example.md
@@ -59,4 +59,4 @@ Main: str GHI
   
 ## See also
 
-- [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/tutorial-chaining-queries-together.md)
+- [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/deferred-execution-and-lazy-evaluation-in-linq-to-xml.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/functional-transformation-of-xml.md b/docs/csharp/programming-guide/concepts/linq/functional-transformation-of-xml.md
@@ -20,7 +20,7 @@ This topic discusses the pure functional transformation approach to modifying XM
 ### XML Functional Transformational Technologies  
  Microsoft offers two functional transformation technologies for use on XML documents: XSLT and LINQ to XML. XSLT is supported in the <xref:System.Xml.Xsl> managed namespace and in the native COM implementation of MSXML. Although XSLT is a robust technology for manipulating XML documents, it requires expertise in a specialized domain, namely the XSLT language and its supporting APIs.  
   
- LINQ to XML provides the tools necessary to code pure functional transformations in an expressive and powerful way, within C# or Visual Basic code. For example, many of the examples in the LINQ to XML documentation use a pure functional approach. Also, in the [Tutorial: Manipulating Content in a WordprocessingML Document (C#)](../../../../csharp/programming-guide/concepts/linq/tutorial-manipulating-content-in-a-wordprocessingml-document.md) tutorial, we use LINQ to XML in a functional approach to manipulate information in a Microsoft Word document.  
+ LINQ to XML provides the tools necessary to code pure functional transformations in an expressive and powerful way, within C# or Visual Basic code. For example, many of the examples in the LINQ to XML documentation use a pure functional approach. Also, in the [Tutorial: Manipulating Content in a WordprocessingML Document (C#)](../../../../csharp/programming-guide/concepts/linq/shape-of-wordprocessingml-documents.md) tutorial, we use LINQ to XML in a functional approach to manipulate information in a Microsoft Word document.  
   
  For a more complete comparison of LINQ to XML with other Microsoft XML technologies, see [LINQ to XML vs. Other XML Technologies](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-vs-other-xml-technologies.md).  
   
@@ -29,5 +29,5 @@ This topic discusses the pure functional transformation approach to modifying XM
 ## See also
 
 - [Introduction to Pure Functional Transformations (C#)](../../../../csharp/programming-guide/concepts/linq/introduction-to-pure-functional-transformations.md)
-- [Tutorial: Manipulating Content in a WordprocessingML Document (C#)](../../../../csharp/programming-guide/concepts/linq/tutorial-manipulating-content-in-a-wordprocessingml-document.md)
+- [Tutorial: Manipulating Content in a WordprocessingML Document (C#)](../../../../csharp/programming-guide/concepts/linq/shape-of-wordprocessingml-documents.md)
 - [LINQ to XML vs. Other XML Technologies](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-vs-other-xml-technologies.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-filter-on-an-attribute-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-filter-on-an-attribute-xpath-linq-to-xml.md
@@ -65,7 +65,3 @@ Results are identical
   <Country>USA</Country>  
 </Address>  
 ```  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-a-child-element-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-a-child-element-xpath-linq-to-xml.md
@@ -38,7 +38,4 @@ Console.WriteLine(el1);
 Results are identical  
 <DeliveryNotes>Please leave packages in shed by driveway.</DeliveryNotes>  
 ```  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
+  
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-a-list-of-child-elements-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-a-list-of-child-elements-xpath-linq-to-xml.md
@@ -43,7 +43,4 @@ Results are identical
 <Zip>10999</Zip>  
 <Country>USA</Country>  
 ```  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
+  
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-a-union-of-two-location-paths-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-a-union-of-two-location-paths-xpath-linq-to-xml.md
@@ -61,7 +61,4 @@ Results are identical
 <Category>B</Category>  
 <Price>6.99</Price>  
 ```  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
+  
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-an-attribute-of-the-parent-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-an-attribute-of-the-parent-xpath-linq-to-xml.md
@@ -47,6 +47,3 @@ Results are identical
 id="bk101"  
 ```  
   
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-attributes-of-siblings-with-a-specific-name-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-attributes-of-siblings-with-a-specific-name-xpath-linq-to-xml.md
@@ -48,7 +48,4 @@ Results are identical
 id="bk101"  
 id="bk102"  
 ```  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
+  
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-child-elements-based-on-position-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-child-elements-based-on-position-xpath-linq-to-xml.md
@@ -71,7 +71,3 @@ Results are identical
   <Output>b1</Output>  
 </Test>  
 ```  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-descendant-elements-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-descendant-elements-xpath-linq-to-xml.md
@@ -42,7 +42,3 @@ Results are identical
 <Name>Jessica Arnold</Name>  
 <Name>Jessica Arnold</Name>  
 ```  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-descendants-of-a-child-element-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-descendants-of-a-child-element-xpath-linq-to-xml.md
@@ -68,7 +68,4 @@ Console.WriteLine(str2);
 Results are identical  
 This is the start of a sentence.  This is a second sentence.  
 ```  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
+  
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-elements-in-a-namespace-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-elements-in-a-namespace-xpath-linq-to-xml.md
@@ -68,6 +68,3 @@ Results are identical
   </aw:PurchaseOrder>  
 ```  
   
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-elements-with-a-specific-attribute-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-elements-with-a-specific-attribute-xpath-linq-to-xml.md
@@ -49,7 +49,4 @@ Results are identical
 <Child2 Select="true">2</Child2>  
 <Child4 Select="true">4</Child4>  
 ```  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
+  
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-preceding-siblings-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-preceding-siblings-xpath-linq-to-xml.md
@@ -46,7 +46,3 @@ Results are identical
 <ContactTitle>Marketing Manager</ContactTitle>  
 <Phone>(503) 555-7555</Phone>  
 ```  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-related-elements-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-related-elements-xpath-linq-to-xml.md
@@ -77,7 +77,4 @@ Results are identical
   </FullAddress>  
 </Customer>  
 ```  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
+ 
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-sibling-nodes-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-sibling-nodes-xpath-linq-to-xml.md
@@ -67,7 +67,3 @@ Results are identical
       of the world.</Description>  
 </Book>  
 ```  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-the-immediate-preceding-sibling-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-the-immediate-preceding-sibling-xpath-linq-to-xml.md
@@ -45,7 +45,3 @@ Console.WriteLine(el1);
 Results are identical  
 <Child3 />  
 ```  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-find-the-root-element-xpath-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-find-the-root-element-xpath-linq-to-xml.md
@@ -37,7 +37,3 @@ Console.WriteLine(el1.Name);
 Results are identical  
 PurchaseOrders  
 ```  
-  
-## See also
-
-- [LINQ to XML for XPath Users (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/intermediate-materialization.md b/docs/csharp/programming-guide/concepts/linq/intermediate-materialization.md
@@ -82,4 +82,4 @@ Main: str >GHI!!!<
   
 ## See also
 
-- [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/tutorial-chaining-queries-together.md)
+- [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/deferred-execution-and-lazy-evaluation-in-linq-to-xml.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/introduction-to-pure-functional-transformations.md b/docs/csharp/programming-guide/concepts/linq/introduction-to-pure-functional-transformations.md
@@ -6,6 +6,10 @@ ms.assetid: 8495c9d9-2d02-4aa0-8a10-9e8794b985fe
 # Introduction to Pure Functional Transformations (C#)
 This section introduces functional transformations, including the underlying concepts and supporting language constructs. It contrasts the object-oriented and functional transformation approaches to programming, including advice on how to transition to the latter. Although functional transformations can be used in many programming scenarios, XML transformation is used here as a concrete example.  
   
+ The [Tutorial: Manipulating Content in a WordprocessingML Document (C#)](../../../../csharp/programming-guide/concepts/linq/shape-of-wordprocessingml-documents.md) tutorial provides a series of examples, each building on the previous one. These examples demonstrate the pure functional transformational approach to manipulating XML. This tutorial assumes a working knowledge of C#. Detailed semantics of the language constructs are not provided in this tutorial, but links are provided to the language documentation as appropriate.  
+  
+ A working knowledge of basic computer science concepts and XML, including XML namespaces, is also assumed.  
+  
 ## In This Section  
   
 |Topic|Description|  
@@ -15,7 +19,4 @@ This section introduces functional transformations, including the underlying con
 |[Refactoring Into Pure Functions (C#)](../../../../csharp/programming-guide/concepts/linq/refactoring-into-pure-functions.md)|Introduces pure functions, and shows examples of and pure and impure functions.|  
 |[Applicability of Functional Transformation (C#)](../../../../csharp/programming-guide/concepts/linq/applicability-of-functional-transformation.md)|Describes typical scenarios for functional transformations.|  
 |[Functional Transformation of XML (Visual Basic)](../../../../visual-basic/programming-guide/concepts/linq/functional-transformation-of-xml.md)|Describes functional transformations in the context of transforming XML trees.|  
-  
-## See also
-
-- [Pure Functional Transformations of XML (C#)](../../../../csharp/programming-guide/concepts/linq/pure-functional-transformations-of-xml.md)
+  
diff --git a/docs/csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md b/docs/csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md
diff --git a/docs/csharp/programming-guide/concepts/linq/pure-functional-transformations-of-xml.md b/docs/csharp/programming-guide/concepts/linq/pure-functional-transformations-of-xml.md
diff --git a/docs/csharp/programming-guide/concepts/linq/refactoring-into-pure-functions.md b/docs/csharp/programming-guide/concepts/linq/refactoring-into-pure-functions.md
diff --git a/docs/csharp/programming-guide/concepts/linq/toc.yml b/docs/csharp/programming-guide/concepts/linq/toc.yml
diff --git a/docs/csharp/programming-guide/concepts/linq/tutorial-chaining-queries-together.md b/docs/csharp/programming-guide/concepts/linq/tutorial-chaining-queries-together.md

Original file line number	Diff line number	Diff line change
`@@ -82,4 +82,4 @@ Main: str >GHI!!!<`
`82`	`82`
`83`	`83`	`## See also`
`84`	`84`
`85`		`-- [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/tutorial-chaining-queries-together.md)`
	`85`	`+- [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/deferred-execution-and-lazy-evaluation-in-linq-to-xml.md)`
Original file line number	Diff line number	Diff line change
`@@ -59,4 +59,4 @@ Main: str GHI`
`59`	`59`
`60`	`60`	`## See also`
`61`	`61`
`62`		`-- [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/tutorial-chaining-queries-together.md)`
	`62`	`+- [Tutorial: Chaining Queries Together (C#)](../../../../csharp/programming-guide/concepts/linq/deferred-execution-and-lazy-evaluation-in-linq-to-xml.md)`