dotnet · BillWagner · Jul 28, 2020 · Jul 24, 2020 · Jul 27, 2020
diff --git a/docs/csharp/programming-guide/xmldoc/include.md b/docs/csharp/programming-guide/xmldoc/include.md
@@ -1,5 +1,6 @@
 ---
 title: "<include> - C# programming guide"
+description: Learn about the XML <include> tag. This tag lets you refer to comments in another file that describe the types and members in your source code.
 ms.date: 07/20/2015
 f1_keywords:
   - "include"

diff --git a/docs/csharp/programming-guide/xmldoc/list.md b/docs/csharp/programming-guide/xmldoc/list.md
@@ -1,5 +1,6 @@
 ---
 title: "<list> - C# programming guide"
+description: Learn about the XML <list> tag. This tag is used to create tables and definition, bulleted, or numbered lists by using 'item' blocks.
 ms.date: 07/20/2015
 f1_keywords:
   - "list"

diff --git a/docs/csharp/programming-guide/xmldoc/para.md b/docs/csharp/programming-guide/xmldoc/para.md
@@ -1,5 +1,6 @@
 ---
 title: "<para> - C# programming guide"
+description: Learn about the XML <para> tag. This tag lets you add structure to the text in another tag, such as <summary>, <remarks>, or <returns>.
 ms.date: 07/20/2015
 f1_keywords:
   - "<para>"

diff --git a/docs/csharp/programming-guide/xmldoc/param.md b/docs/csharp/programming-guide/xmldoc/param.md
@@ -1,5 +1,6 @@
 ---
 title: "<param> - C# programming guide"
+description: Learn about the XML <param> tag. This tag is used in the comment for a method declaration to describe one of the parameters for the method.
 ms.date: 07/20/2015
 f1_keywords:
   - "param"

diff --git a/docs/csharp/programming-guide/xmldoc/paramref.md b/docs/csharp/programming-guide/xmldoc/paramref.md
@@ -1,5 +1,6 @@
 ---
 title: "<paramref> - C# programming guide"
+description: Learn about the XML <paramref> tag. This tag gives you a way to indicate that a word in the code is a parameter.
 ms.date: 07/20/2015
 f1_keywords:
   - "paramref"

diff --git a/docs/csharp/programming-guide/xmldoc/permission.md b/docs/csharp/programming-guide/xmldoc/permission.md
@@ -1,5 +1,6 @@
 ---
 title: "<permission> - C# programming guide"
+description: Learn about the XML <permission> tag. This tag lets you document the access of a member, while the PermissionSet class lets you specify access to a member.
 ms.date: 07/20/2015
 f1_keywords:
   - "permission"

diff --git a/docs/csharp/programming-guide/xmldoc/processing-the-xml-file.md b/docs/csharp/programming-guide/xmldoc/processing-the-xml-file.md
@@ -1,5 +1,6 @@
 ---
 title: "Processing the XML file - C# programming guide"
+description: Learn about processing the XML file in C# programming. See code examples and view additional available resources.
 ms.date: 07/20/2015
 helpviewer_keywords:
   - "XML processing [C#]"

diff --git a/.../csharp/programming-guide/xmldoc/recommended-tags-for-documentation-comments.md b/.../csharp/programming-guide/xmldoc/recommended-tags-for-documentation-comments.md
@@ -1,5 +1,6 @@
 ---
 title: "Recommended tags for documentation comments - C# programming guide"
+description: Learn about the recommended tags for documentation comments. See a list of recommended tags and view additional available resources.
 ms.date: 01/21/2020
 helpviewer_keywords:
   - "XML [C#], tags"

diff --git a/docs/csharp/programming-guide/xmldoc/remarks.md b/docs/csharp/programming-guide/xmldoc/remarks.md
@@ -1,5 +1,6 @@
 ---
 title: "<remarks> - C# programming guide"
+description: Learn about the XML <remarks> tag. This tag is used to add information about a type, supplementing the information specified with <summary>.
 ms.date: 07/20/2015
 f1_keywords:
   - "remarks"

diff --git a/docs/csharp/programming-guide/xmldoc/returns.md b/docs/csharp/programming-guide/xmldoc/returns.md
@@ -1,5 +1,6 @@
 ---
 title: "<returns> - C# programming guide"
+description: Learn about the XML <returns> tag. This tag is used in the comment for a method declaration to describe the return value.
 ms.date: 07/20/2015
 f1_keywords:
   - "returns"

diff --git a/docs/csharp/programming-guide/xmldoc/see.md b/docs/csharp/programming-guide/xmldoc/see.md
@@ -1,5 +1,6 @@
 ---
 title: "<see> - C# programming guide"
+description: Learn about the XML <see> tag. This tag lets you specify a link from within text, for example by using a cref attribute.
 ms.date: 07/20/2015
 f1_keywords:
   - "<see>"

diff --git a/docs/csharp/programming-guide/xmldoc/seealso.md b/docs/csharp/programming-guide/xmldoc/seealso.md
@@ -1,5 +1,6 @@
 ---
 title: "<seealso> - C# programming guide"
+description: Learn how to use the XML <seealso> tag. This tag lets you specify the text that you might want to appear in a 'See Also' section.
 ms.date: 07/20/2015
 f1_keywords:
   - "cref"

diff --git a/docs/csharp/programming-guide/xmldoc/summary.md b/docs/csharp/programming-guide/xmldoc/summary.md
@@ -1,5 +1,6 @@
 ---
 title: "<summary> - C# programming guide"
+description: Learn about the XML <summary> tag that is used to describe a type or a type member. See code examples and view additional available resources.
 ms.date: 07/20/2015
 f1_keywords:
   - "<summary>"

diff --git a/docs/csharp/programming-guide/xmldoc/typeparam.md b/docs/csharp/programming-guide/xmldoc/typeparam.md
@@ -1,5 +1,6 @@
 ---
 title: "<typeparam> - C# programming guide"
+description: Learn about the XML <typeparam> tag. This tag is used in the comment for a generic type or method declaration to describe a type parameter.
 ms.date: 07/20/2015
 f1_keywords:
   - "typeparam"

diff --git a/docs/csharp/programming-guide/xmldoc/typeparamref.md b/docs/csharp/programming-guide/xmldoc/typeparamref.md
@@ -1,5 +1,6 @@
 ---
 title: "<typeparamref> - C# programming guide"
+description: Learn about the XML <typeparamref> tag. This tag enables consumers of the documentation file to format the word in some distinct way, for example in italics.
 ms.date: 07/20/2015
 f1_keywords:
   - "typeparamref"

diff --git a/docs/csharp/programming-guide/xmldoc/value.md b/docs/csharp/programming-guide/xmldoc/value.md
@@ -1,5 +1,6 @@
 ---
 title: "<value> - C# programming guide"
+description: Learn about the XML <value> tag. This tag allows you to describe the value that a property represents.
 ms.date: 07/20/2015
 f1_keywords:
   - "<value>"

diff --git a/docs/csharp/walkthroughs.md b/docs/csharp/walkthroughs.md
@@ -1,5 +1,6 @@
 ---
 title: "C# walkthroughs"
+description: See step-by-step instructions for common scenarios. These C# walkthroughs are a good place to start learning about a product or particular feature area.
 ms.date: 07/20/2015
 helpviewer_keywords:
   - "walkthroughs [C#]"