diff --git a/docs/csharp/programming-guide/xmldoc/how-to-use-the-xml-documentation-features.md b/docs/csharp/programming-guide/xmldoc/how-to-use-the-xml-documentation-features.md
index 6c0c8e26746a1..f6586cc546015 100644
--- a/docs/csharp/programming-guide/xmldoc/how-to-use-the-xml-documentation-features.md
+++ b/docs/csharp/programming-guide/xmldoc/how-to-use-the-xml-documentation-features.md
@@ -11,58 +11,61 @@ The following sample provides a basic overview of a type that has been documente
## Example
[!code-csharp[csProgGuideDocComments#15](../../../csharp/programming-guide/xmldoc/codesnippet/CSharp/how-to-use-the-xml-documentation-features_1.cs)]
-
- **// This .xml file was generated with the previous code sample.**
-**\**
-**\**
- **\**
- **\xmlsample\**
- **\**
- **\**
- **\**
- **\**
- **Class level summary documentation goes here.\**
- **\**
- **Longer comments can be associated with a type or member**
- **through the remarks tag\**
- **\**
- **\**
- **\**
- **Store for the name property\**
- **\**
- **\**
- **\The class constructor.\**
- **\**
- **\**
- **\**
- **Description for SomeMethod.\**
- **\ Parameter description for s goes here\**
- **\**
- **You can use the cref attribute on any tag to reference a type or member**
- **and the compiler will check that the reference exists. \**
- **\**
- **\**
- **\**
- **Some other method. \**
- **\**
- **Return results are described through the returns tag.\**
- **\**
- **Notice the use of the cref attribute to reference a specific method \**
- **\**
- **\**
- **\**
- **The entry point for the application.**
- **\**
- **\ A list of command line arguments\**
- **\**
- **\**
- **\**
- **Name property \**
- **\**
- **A value tag is used to describe the property value\**
- **\**
- **\**
-**\**
+
+The example generates an .xml file with the following contents:
+
+```xml
+
+
+
+ xmlsample
+
+
+
+
+ Class level summary documentation goes here.
+
+ Longer comments can be associated with a type or member
+ through the remarks tag
+
+
+
+ Store for the name property
+
+
+ The class constructor.
+
+
+
+ Description for SomeMethod.
+ Parameter description for s goes here
+
+ You can use the cref attribute on any tag to reference a type or member
+ and the compiler will check that the reference exists.
+
+
+
+ Some other method.
+
+ Return results are described through the returns tag.
+
+ Notice the use of the cref attribute to reference a specific method
+
+
+
+ The entry point for the application.
+
+ A list of command line arguments
+
+
+
+ Name property
+ A value tag is used to describe the property value
+
+
+
+```
+
## Compiling the Code
To compile the example, type the following command line:
@@ -75,7 +78,7 @@ The following sample provides a basic overview of a type that has been documente
- The documentation must be well-formed XML. If the XML is not well-formed, a warning is generated and the documentation file will contain a comment that says that an error was encountered.
-- Developers are free to create their own set of tags. There is a recommended set of tags (see the Further Reading section). Some of the recommended tags have special meanings:
+- Developers are free to create their own set of tags. There is a recommended set of tags (see [Recommended tags for documentation comments](recommended-tags-for-documentation-comments.md)). Some of the recommended tags have special meanings:
- The \ tag is used to describe parameters. If used, the compiler will verify that the parameter exists and that all parameters are described in the documentation. If the verification failed, the compiler issues a warning.