TOC changes for linq to XML - Part 2 (#12583)

BillWagner · web-flow · commit 3df8ec3b333c · 2019-06-03T16:55:33.000-04:00
* Up through parsing XML

* first working with namespaces node

* add serializing folder

* The LINQ to XML Axes folder.

* respond to feedback.
diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json
@@ -728,6 +728,22 @@
             "source_path": "docs/csharp/programming-guide/concepts/linq/programming-guide-linq-to-xml.md",
             "redirect_url": "/dotnet/csharp/programming-guide/concepts/linq/linq-to-xml-overview"
         },
+        {
+            "source_path": "docs/csharp/programming-guide/concepts/linq/linq-to-xml-axes.md",
+            "redirect_url": "/dotnet/csharp/programming-guide/concepts/linq/linq-to-xml-axes-overview"
+        },
+        {
+            "source_path": "docs/csharp/programming-guide/concepts/linq/parsing-xml.md",
+            "redirect_url": "/dotnet/csharp/programming-guide/concepts/linq/how-to-parse-a-string"
+        },
+        {
+            "source_path": "docs/csharp/programming-guide/concepts/linq/serializing-xml-trees.md",
+            "redirect_url": "/dotnet/csharp/programming-guide/concepts/linq/serializing-to-files-textwriters-and-xmlwriters"
+        },
+        {
+            "source_path": "docs/csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md",
+            "redirect_url": "/dotnet/csharp/programming-guide/concepts/linq/namespaces-overview-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/how-to-catch-parsing-errors.md b/docs/csharp/programming-guide/concepts/linq/how-to-catch-parsing-errors.md
@@ -35,7 +35,4 @@ The 'Contacts' start tag on line 1 does not match the end tag of 'Contcts'. Line
 ```  
   
  For information about the exceptions that you can expect the <xref:System.Xml.Linq.XElement.Parse%2A?displayProperty=nameWithType>, <xref:System.Xml.Linq.XDocument.Parse%2A?displayProperty=nameWithType>, <xref:System.Xml.Linq.XElement.Load%2A?displayProperty=nameWithType>, and <xref:System.Xml.Linq.XDocument.Load%2A?displayProperty=nameWithType> methods to throw, see the <xref:System.Xml.XmlReader> documentation.  
-  
-## See also
-
-- [Parsing XML (C#)](../../../../csharp/programming-guide/concepts/linq/parsing-xml.md)
+  
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-chain-axis-method-calls-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-chain-axis-method-calls-linq-to-xml.md
@@ -82,7 +82,7 @@ foreach (XElement cp in configParameters)
 ```  
   
 ## Example  
- The following example shows the same technique for XML that is in a namespace. For more information, see [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md).  
+ The following example shows the same technique for XML that is in a namespace. For more information, see [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/namespaces-overview-linq-to-xml.md).  
   
  This example uses the following XML document: [Sample XML File: Multiple Purchase Orders in a Namespace](../../../../csharp/programming-guide/concepts/linq/sample-xml-file-multiple-purchase-orders-in-a-namespace.md).  
   
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-control-namespace-prefixes-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-control-namespace-prefixes-linq-to-xml.md
@@ -50,4 +50,4 @@ Console.WriteLine(root);
   
 ## See also
 
-- [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md)
+- [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/namespaces-overview-linq-to-xml.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-create-a-document-with-namespaces-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-create-a-document-with-namespaces-linq-to-xml.md
@@ -138,4 +138,4 @@ Console.WriteLine(root);
   
 ## See also
 
-- [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md)
+- [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/namespaces-overview-linq-to-xml.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-filter-on-element-names-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-filter-on-element-names-linq-to-xml.md
@@ -44,7 +44,7 @@ ProductName:Baby Monitor
 - <xref:System.Xml.Linq.XElement.DescendantsAndSelf%2A>  
   
 ## Example  
- The following example shows the same query for XML that is in a namespace. For more information, see [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md).  
+ The following example shows the same query for XML that is in a namespace. For more information, see [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/namespaces-overview-linq-to-xml.md).  
   
  This example uses the following XML document: [Sample XML File: Typical Purchase Order in a Namespace](../../../../csharp/programming-guide/concepts/linq/sample-xml-file-typical-purchase-order-in-a-namespace.md).  
   
@@ -67,4 +67,4 @@ foreach (XElement prdName in items)
   
 ## See also
 
-- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes.md)
+- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes-overview.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-load-xml-from-a-file.md b/docs/csharp/programming-guide/concepts/linq/how-to-load-xml-from-a-file.md
@@ -41,7 +41,4 @@ Console.WriteLine(booksFromFile);
   </Book>  
 </Catalog>  
 ```  
-  
-## See also
-
-- [Parsing XML (C#)](../../../../csharp/programming-guide/concepts/linq/parsing-xml.md)
+  
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-parse-a-string.md b/docs/csharp/programming-guide/concepts/linq/how-to-parse-a-string.md
@@ -38,7 +38,3 @@ XElement contacts = XElement.Parse(
     </Contacts>");  
 Console.WriteLine(contacts);  
 ```  
-  
-## See also
-
-- [Parsing XML (C#)](../../../../csharp/programming-guide/concepts/linq/parsing-xml.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-populate-an-xml-tree-with-an-xmlwriter-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-populate-an-xml-tree-with-an-xmlwriter-linq-to-xml.md
@@ -61,4 +61,4 @@ Console.WriteLine(newTree);
 - <xref:System.Xml.Linq.XContainer.CreateWriter%2A>
 - <xref:System.Xml.XmlWriter>
 - <xref:System.Xml.Xsl.XslCompiledTransform>
-- [Creating XML Trees (C#)](../../../../csharp/programming-guide/concepts/linq/creating-xml-trees.md)
+- [Creating XML Trees (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-overview.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-retrieve-a-collection-of-attributes-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-retrieve-a-collection-of-attributes-linq-to-xml.md
@@ -32,4 +32,4 @@ ConvertableTo="double"
   
 ## See also
 
-- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes.md)
+- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes-overview.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-retrieve-a-collection-of-elements-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-retrieve-a-collection-of-elements-linq-to-xml.md
@@ -31,4 +31,4 @@ Name: Items
   
 ## See also
 
-- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes.md)
+- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes-overview.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-retrieve-a-single-attribute-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-retrieve-a-single-attribute-linq-to-xml.md
@@ -65,7 +65,7 @@ work
  [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] provides explicit cast operators for the <xref:System.Xml.Linq.XAttribute> class to `string`, `bool`, `bool?`, `int`, `int?`, `uint`, `uint?`, `long`, `long?`, `ulong`, `ulong?`, `float`, `float?`, `double`, `double?`, `decimal`, `decimal?`, `DateTime`, `DateTime?`, `TimeSpan`, `TimeSpan?`, `GUID`, and `GUID?`.  
   
 ## Example  
- The following example shows the same code for an attribute that is in a namespace. For more information, see [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md).  
+ The following example shows the same code for an attribute that is in a namespace. For more information, see [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/namespaces-overview-linq-to-xml.md).  
   
 ```csharp  
 XNamespace aw = "http://www.adventure-works.com";  
@@ -93,4 +93,4 @@ work
   
 ## See also
 
-- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes.md)
+- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes-overview.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-retrieve-a-single-child-element-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-retrieve-a-single-child-element-linq-to-xml.md
@@ -30,7 +30,7 @@ Console.WriteLine(e);
 ```  
   
 ## Example  
- The following example shows the same code for XML that is in a namespace. For more information, see [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md).  
+ The following example shows the same code for XML that is in a namespace. For more information, see [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/namespaces-overview-linq-to-xml.md).  
   
  This example uses the following XML document: [Sample XML File: Typical Purchase Order in a Namespace](../../../../csharp/programming-guide/concepts/linq/sample-xml-file-typical-purchase-order-in-a-namespace.md).  
   
@@ -49,4 +49,4 @@ Console.WriteLine(e);
   
 ## See also
 
-- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes.md)
+- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes-overview.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-retrieve-the-shallow-value-of-an-element.md b/docs/csharp/programming-guide/concepts/linq/how-to-retrieve-the-shallow-value-of-an-element.md
@@ -75,4 +75,4 @@ Column  Name="Name"         =Customer.Name
   
 ## See also
 
-- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes.md)
+- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes-overview.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-retrieve-the-value-of-an-attribute-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-retrieve-the-value-of-an-attribute-linq-to-xml.md
@@ -26,7 +26,7 @@ abcde
 ```  
   
 ## Example  
- The following example shows how to retrieve the value of an attribute where the attribute is in a namespace. For more information, see [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md).  
+ The following example shows how to retrieve the value of an attribute where the attribute is in a namespace. For more information, see [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/namespaces-overview-linq-to-xml.md).  
   
 ```csharp  
 XNamespace aw = "http://www.adventure-works.com";  
@@ -45,4 +45,4 @@ abcde
   
 ## See also
 
-- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes.md)
+- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes-overview.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-retrieve-the-value-of-an-element-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-retrieve-the-value-of-an-element-linq-to-xml.md
@@ -141,4 +141,4 @@ v4:element does not exist
   
 ## See also
 
-- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes.md)
+- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes-overview.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-stream-xml-fragments-from-an-xmlreader.md b/docs/csharp/programming-guide/concepts/linq/how-to-stream-xml-fragments-from-an-xmlreader.md
@@ -75,7 +75,4 @@ ccc
 ```  
   
  In this example, the source document is very small. However, even if there were millions of `Child` elements, this example would still have a small memory footprint.  
-  
-## See also
-
-- [Parsing XML (C#)](../../../../csharp/programming-guide/concepts/linq/parsing-xml.md)
+  
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-validate-using-xsd-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/how-to-validate-using-xsd-linq-to-xml.md
@@ -117,4 +117,4 @@ custOrdDoc did not validate
 ## See also
 
 - <xref:System.Xml.Schema.Extensions.Validate%2A>
-- [Creating XML Trees (C#)](../../../../csharp/programming-guide/concepts/linq/creating-xml-trees.md)
+- [Creating XML Trees (C#)](creating-xml-trees-linq-to-xml-2.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/how-to-write-queries-on-xml-in-namespaces.md b/docs/csharp/programming-guide/concepts/linq/how-to-write-queries-on-xml-in-namespaces.md
@@ -72,4 +72,4 @@ foreach (XElement el in c1)
   
 ## See also
 
-- [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md)
+- [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/namespaces-overview-linq-to-xml.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/linq-to-xml-axes.md b/docs/csharp/programming-guide/concepts/linq/linq-to-xml-axes.md
diff --git a/docs/csharp/programming-guide/concepts/linq/namespaces-overview-linq-to-xml.md b/docs/csharp/programming-guide/concepts/linq/namespaces-overview-linq-to-xml.md
@@ -19,4 +19,4 @@ This topic introduces namespaces, the <xref:System.Xml.Linq.XName> class, and th
   
 ## See also
 
-- [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md)
+- [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/namespaces-overview-linq-to-xml.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/parsing-xml.md b/docs/csharp/programming-guide/concepts/linq/parsing-xml.md
diff --git a/docs/csharp/programming-guide/concepts/linq/preserving-white-space-while-loading-or-parsing-xml1.md b/docs/csharp/programming-guide/concepts/linq/preserving-white-space-while-loading-or-parsing-xml1.md
@@ -30,7 +30,4 @@ This topic describes how to control the white-space behavior of [!INCLUDE[sqltec
  With these methods, if white space is preserved, insignificant white space is inserted into the XML tree as <xref:System.Xml.Linq.XText> nodes. If white space is not preserved, text nodes are not inserted.  
   
  You can create an XML tree by using an <xref:System.Xml.XmlWriter>. Nodes that are written to the <xref:System.Xml.XmlWriter> are populated in the tree. However, when you build an XML tree using this method, all nodes are preserved, regardless of whether the node is white space or not, or whether the white space is significant or not.  
-  
-## See also
-
-- [Parsing XML (C#)](../../../../csharp/programming-guide/concepts/linq/parsing-xml.md)
+  
diff --git a/docs/csharp/programming-guide/concepts/linq/preserving-white-space-while-serializing.md b/docs/csharp/programming-guide/concepts/linq/preserving-white-space-while-serializing.md
@@ -24,7 +24,3 @@ This topic describes how to control white space when serializing an XML tree.
  If the method does not take <xref:System.Xml.Linq.SaveOptions> as an argument, then the method will format (indent) the serialized XML. In this case, all insignificant white space in the XML tree is discarded.  
   
  If the method does take <xref:System.Xml.Linq.SaveOptions> as an argument, then you can specify that the method not format (indent) the serialized XML. In this case, all white space in the XML tree is preserved.  
-  
-## See also
-
-- [Serializing XML Trees (C#)](../../../../csharp/programming-guide/concepts/linq/serializing-xml-trees.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/scope-of-default-namespaces.md b/docs/csharp/programming-guide/concepts/linq/scope-of-default-namespaces.md
@@ -84,4 +84,4 @@ End of result set
   
 ## See also
 
-- [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md)
+- [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/namespaces-overview-linq-to-xml.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/serializing-to-an-xmlreader-invoking-xslt.md b/docs/csharp/programming-guide/concepts/linq/serializing-to-an-xmlreader-invoking-xslt.md
@@ -55,4 +55,4 @@ Console.WriteLine(newTree);
   
 ## See also
 
-- [Serializing XML Trees (C#)](../../../../csharp/programming-guide/concepts/linq/serializing-xml-trees.md)
+- [Serializing XML Trees (C#)](serializing-to-files-textwriters-and-xmlwriters.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/serializing-to-files-textwriters-and-xmlwriters.md b/docs/csharp/programming-guide/concepts/linq/serializing-to-files-textwriters-and-xmlwriters.md
@@ -28,4 +28,4 @@ For examples, see the appropriate reference topic.
 
 ## See also
 
-- [Serializing XML Trees (C#)](../../../../csharp/programming-guide/concepts/linq/serializing-xml-trees.md)
+- [Serializing XML Trees (C#)](serializing-to-files-textwriters-and-xmlwriters.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/serializing-with-an-xml-declaration.md b/docs/csharp/programming-guide/concepts/linq/serializing-with-an-xml-declaration.md
@@ -57,4 +57,4 @@ Console.WriteLine(sb.ToString());
   
 ## See also
 
-- [Serializing XML Trees (C#)](../../../../csharp/programming-guide/concepts/linq/serializing-xml-trees.md)
+- [Serializing XML Trees (C#)](serializing-to-files-textwriters-and-xmlwriters.md)
diff --git a/docs/csharp/programming-guide/concepts/linq/serializing-xml-trees.md b/docs/csharp/programming-guide/concepts/linq/serializing-xml-trees.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/valid-content-of-xelement-and-xdocument-objects3.md b/docs/csharp/programming-guide/concepts/linq/valid-content-of-xelement-and-xdocument-objects3.md
diff --git a/docs/csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md b/docs/csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md

Original file line number	Diff line number	Diff line change
`@@ -50,4 +50,4 @@ Console.WriteLine(root);`
`50`	`50`
`51`	`51`	`## See also`
`52`	`52`
`53`		`-- [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md)`
	`53`	`+- [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/namespaces-overview-linq-to-xml.md)`
Original file line number	Diff line number	Diff line change
`@@ -138,4 +138,4 @@ Console.WriteLine(root);`
`138`	`138`
`139`	`139`	`## See also`
`140`	`140`
`141`		`-- [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/working-with-xml-namespaces.md)`
	`141`	`+- [Working with XML Namespaces (C#)](../../../../csharp/programming-guide/concepts/linq/namespaces-overview-linq-to-xml.md)`
Original file line number	Diff line number	Diff line change
`@@ -32,4 +32,4 @@ ConvertableTo="double"`
`32`	`32`
`33`	`33`	`## See also`
`34`	`34`
`35`		`-- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes.md)`
	`35`	`+- [LINQ to XML Axes (C#)](../../../../csharp/programming-guide/concepts/linq/linq-to-xml-axes-overview.md)`