Add documentation for DOC104-DOC107

Author: sharwell

docs/DOC104.md

@@ -0,0 +1,61 @@
+# DOC104
+
+<table>
+<tr>
+  <td>TypeName</td>
+  <td>DOC104UseSeeLangword</td>
+</tr>
+<tr>
+  <td>CheckId</td>
+  <td>DOC104</td>
+</tr>
+<tr>
+  <td>Category</td>
+  <td>Style Rules</td>
+</tr>
+</table>
+
+## Cause
+
+The contains a language keyword reference using `<c>keyword</c>` that can be converted to the preferred form
+`<see langword="keyword"/>`.
+
+## Rule description
+
+A violation of this rule occurs when documentation a language keyword reference written in inline code that can be
+written in a preferred form using `see langword`.
+
+```csharp
+/// <summary>
+/// This type is <c>sealed</c>.
+/// </summary>
+public sealed class SomeType
+{
+}
+```
+
+## How to fix violations
+
+To fix a violation of this rule, replace the inline code with the equivalent `see langword` syntax.
+
+```csharp
+/// <summary>
+/// This type is <see langword="sealed"/>.
+/// </summary>
+public sealed class SomeType
+{
+}
+```
+
+## How to suppress violations
+
+```csharp
+#pragma warning disable DOC104 // Use 'see langword'
+/// <summary>
+/// This type is <c>sealed</c>.
+/// </summary>
+public sealed class SomeType
+#pragma warning restore DOC104 // Use 'see langword'
+{
+}
+```

docs/DOC105.md

@@ -0,0 +1,61 @@
+# DOC105
+
+<table>
+<tr>
+  <td>TypeName</td>
+  <td>DOC105UseParamref</td>
+</tr>
+<tr>
+  <td>CheckId</td>
+  <td>DOC105</td>
+</tr>
+<tr>
+  <td>Category</td>
+  <td>Style Rules</td>
+</tr>
+</table>
+
+## Cause
+
+The contains a parameter reference using `<c>name</c>` that can be converted to the preferred form
+`<paramref name="name"/>`.
+
+## Rule description
+
+A violation of this rule occurs when documentation contains a parameter reference written in inline code that can be
+written in a preferred form using `paramref`.
+
+```csharp
+/// <summary>
+/// Pass in a <c>value</c>.
+/// </summary>
+public void Method(int value)
+{
+}
+```
+
+## How to fix violations
+
+To fix a violation of this rule, replace the inline code with the equivalent `paramref` syntax.
+
+```csharp
+/// <summary>
+/// Pass in a <paramref name="value"/>.
+/// </summary>
+public void Method(int value)
+{
+}
+```
+
+## How to suppress violations
+
+```csharp
+#pragma warning disable DOC105 // Use 'paramref'
+/// <summary>
+/// Pass in a <c>value</c>.
+/// </summary>
+public void Method(int value)
+#pragma warning restore DOC104 // Use 'paramref'
+{
+}
+```

docs/DOC106.md

@@ -0,0 +1,61 @@
+# DOC106
+
+<table>
+<tr>
+  <td>TypeName</td>
+  <td>DOC106UseTypeparamref</td>
+</tr>
+<tr>
+  <td>CheckId</td>
+  <td>DOC106</td>
+</tr>
+<tr>
+  <td>Category</td>
+  <td>Style Rules</td>
+</tr>
+</table>
+
+## Cause
+
+The contains a type parameter reference using `<c>T</c>` that can be converted to the preferred form
+`<typeparamref name="T"/>`.
+
+## Rule description
+
+A violation of this rule occurs when documentation contains a type parameter reference written in inline code that can
+be written in a preferred form using `typeparamref`.
+
+```csharp
+/// <summary>
+/// Pass in a <c>T</c>.
+/// </summary>
+public void Method<T>()
+{
+}
+```
+
+## How to fix violations
+
+To fix a violation of this rule, replace the inline code with the equivalent `typeparamref` syntax.
+
+```csharp
+/// <summary>
+/// Pass in a <typeparamref name="T"/>.
+/// </summary>
+public void Method<T>()
+{
+}
+```
+
+## How to suppress violations
+
+```csharp
+#pragma warning disable DOC106 // Use 'typeparamref'
+/// <summary>
+/// Pass in a <c>T</c>.
+/// </summary>
+public void Method<T>()
+#pragma warning restore DOC106 // Use 'typeparamref'
+{
+}
+```

docs/DOC107.md

@@ -0,0 +1,67 @@
+# DOC107
+
+<table>
+<tr>
+  <td>TypeName</td>
+  <td>DOC107UseSeeCref</td>
+</tr>
+<tr>
+  <td>CheckId</td>
+  <td>DOC107</td>
+</tr>
+<tr>
+  <td>Category</td>
+  <td>Style Rules</td>
+</tr>
+</table>
+
+## Cause
+
+The contains a code element reference using `<c>name</c>` that can be converted to the preferred form
+`<see cref="name"/>`.
+
+## Rule description
+
+A violation of this rule occurs when documentation contains a code element reference written in inline code that can
+be written in a preferred form using `see cref`.
+
+```csharp
+int SomeValue { get; }
+
+/// <summary>
+/// Depends on <c>SomeValue</c>.
+/// </summary>
+public void Method()
+{
+}
+```
+
+## How to fix violations
+
+To fix a violation of this rule, replace the inline code with the equivalent `see cref` syntax.
+
+```csharp
+int SomeValue { get; }
+
+/// <summary>
+/// Depends on <see cref="SomeValue"/>.
+/// </summary>
+public void Method()
+{
+}
+```
+
+## How to suppress violations
+
+```csharp
+int SomeValue { get; }
+
+#pragma warning disable DOC107 // Use 'see cref'
+/// <summary>
+/// Depends on <c>SomeValue</c>.
+/// </summary>
+public void Method()
+#pragma warning restore DOC107 // Use 'see cref'
+{
+}
+```

docs/StyleRules.md

@@ -8,4 +8,8 @@ Identifier | Name | Description
 [DOC101](DOC101.md) | UseChildBlocksConsistently | The documentation for the element contains some text which is wrapped in block-level elements, and other text which is written inline.
 [DOC102](DOC102.md) | UseChildBlocksConsistentlyAcrossElementsOfTheSameKind | The documentation for the element contains inline text, but the documentation for a sibling element of the same kind uses block-level elements.
 [DOC103](DOC103.md) | UseUnicodeCharacters | The documentation contains an unnecessary or unrecognized HTML character entity.
+[DOC104](DOC104.md) | UseSeeLangword | The contains a language keyword reference using `<c>keyword</c>` that can be converted to the preferred form `<see langword="keyword"/>`.
+[DOC105](DOC105.md) | UseParamref | The contains a parameter reference using `<c>name</c>` that can be converted to the preferred form `<paramref name="name"/>`.
+[DOC106](DOC106.md) | UseTypeparamref | The contains a type parameter reference using `<c>T</c>` that can be converted to the preferred form `<typeparamref name="T"/>`.
+[DOC107](DOC107.md) | UseSeeCref | The contains a code element reference using `<c>name</c>` that can be converted to the preferred form `<see cref="name"/>`.
 [DOC108](DOC108.md) | AvoidEmptyParagraphs | The documentation contains an empty paragraph element (`<para/>` or `<p/>`) used as a paragraph separator.