Bump docfx from 2.74.0 to 2.76.0 (#1524)

Author: dependabot[bot]

.config/dotnet-tools.json

@@ -21,7 +21,7 @@
       ]
     },
     "docfx": {
-      "version": "2.74.0",
+      "version": "2.76.0",
       "commands": [
         "docfx"
       ]

docs/docfx.json

@@ -24,6 +24,9 @@
                     "internals/**.md",
                     "toc.yml",
                     "*.md"
+                ],
+                "exclude": [
+                    "**/README.md"
                 ]
             }
         ],

docs/request-examples/index.md

@@ -1,3 +1,7 @@
+---
+_disableToc: true
+---
+
 # Example requests
 
 These requests have been generated against the "GettingStarted" application and are updated on every deployment.

docs/request-examples/toc.md

@@ -49,7 +49,7 @@ internal FieldChainPattern(FieldTypes choices, bool atLeastOne, bool atMostOne,
     /// </summary>
     /// <remarks>
     /// Patterns are similar to regular expressions, but a lot simpler. They consist of a sequence of terms. A term can be a single character or a character
-    /// choice, optionally followed by a quantifier.
+    /// choice. A term is optionally followed by a quantifier.
     /// <p>
     /// The following characters can be used:
     /// <list type="table">
@@ -58,18 +58,26 @@ internal FieldChainPattern(FieldTypes choices, bool atLeastOne, bool atMostOne,
     /// <description>
     /// Matches a to-many relationship.
     /// </description>
+    /// </item>
+    /// <item>
     /// <term>O</term>
     /// <description>
     /// Matches a to-one relationship.
     /// </description>
+    /// </item>
+    /// <item>
     /// <term>R</term>
     /// <description>
     /// Matches a relationship.
     /// </description>
+    /// </item>
+    /// <item>
     /// <term>A</term>
     /// <description>
     /// Matches an attribute.
     /// </description>
+    /// </item>
+    /// <item>
     /// <term>F</term>
     /// <description>
     /// Matches a field.
@@ -86,15 +94,19 @@ internal FieldChainPattern(FieldTypes choices, bool atLeastOne, bool atMostOne,
     /// <item>
     /// <term>?</term>
     /// <description>
-    /// Matches its term zero or one times.
+    /// Matches its preceding term zero or one times.
     /// </description>
+    /// </item>
+    /// <item>
     /// <term>*</term>
     /// <description>
-    /// Matches its term zero or more times.
+    /// Matches its preceding term zero or more times.
     /// </description>
+    /// </item>
+    /// <item>
     /// <term>+</term>
     /// <description>
-    /// Matches its term one or more times.
+    /// Matches its preceding term one or more times.
     /// </description>
     /// </item>
     /// </list>

src/JsonApiDotNetCore/QueryStrings/FieldChains/FieldChainPattern.cs

@@ -13,22 +13,22 @@ public interface IDocumentAdapter
     /// <list type="bullet">
     /// <item>
     /// <description>
-    /// <code><![CDATA[IList<OperationContainer>]]></code> (operations)
+    /// <c><![CDATA[IList<OperationContainer>]]></c> (operations)
     /// </description>
     /// </item>
     /// <item>
     /// <description>
-    /// <code><![CDATA[ISet<IIdentifiable>]]></code> (to-many relationship, unknown relationship)
+    /// <c><![CDATA[ISet<IIdentifiable>]]></c> (to-many relationship, unknown relationship)
     /// </description>
     /// </item>
     /// <item>
     /// <description>
-    /// <code><![CDATA[IIdentifiable]]></code> (resource, to-one relationship)
+    /// <c><![CDATA[IIdentifiable]]></c> (resource, to-one relationship)
     /// </description>
     /// </item>
     /// <item>
     /// <description>
-    /// <code><![CDATA[null]]></code> (to-one relationship)
+    /// <c><![CDATA[null]]></c> (to-one relationship)
     /// </description>
     /// </item>
     /// </list>

src/JsonApiDotNetCore/Serialization/Request/Adapters/IDocumentAdapter.cs

@@ -12,32 +12,32 @@ public interface IResponseModelAdapter
     /// <list type="bullet">
     /// <item>
     /// <description>
-    /// <code><![CDATA[IEnumerable<IIdentifiable>]]></code>
+    /// <c><![CDATA[IEnumerable<IIdentifiable>]]></c>
     /// </description>
     /// </item>
     /// <item>
     /// <description>
-    /// <code><![CDATA[IIdentifiable]]></code>
+    /// <c><![CDATA[IIdentifiable]]></c>
     /// </description>
     /// </item>
     /// <item>
     /// <description>
-    /// <code><![CDATA[null]]></code>
+    /// <c><![CDATA[null]]></c>
     /// </description>
     /// </item>
     /// <item>
     /// <description>
-    /// <code><![CDATA[IEnumerable<OperationContainer?>]]></code>
+    /// <c><![CDATA[IEnumerable<OperationContainer?>]]></c>
     /// </description>
     /// </item>
     /// <item>
     /// <description>
-    /// <code><![CDATA[IEnumerable<ErrorObject>]]></code>
+    /// <c><![CDATA[IEnumerable<ErrorObject>]]></c>
     /// </description>
     /// </item>
     /// <item>
     /// <description>
-    /// <code><![CDATA[ErrorObject]]></code>
+    /// <c><![CDATA[ErrorObject]]></c>
     /// </description>
     /// </item>
     /// </list>