Update the documentation pages

configuration/application-permissions.html

@@ -283,8 +283,8 @@ if (await manager.FindByClientIdAsync("console") is null)
         options.IgnoreScopePermissions();
     });
 </code></pre><h2 id="response-type-permissions">Response type permissions</h2>
-<p>-&gt; [!NOTE]
+<div class="NOTE"><h5>Note</h5><p>Response type permissions were introduced in OpenIddict 3.0.</p>
--&gt; Response type permissions were introduced in OpenIddict 3.0.</p>
+</div>
 <h3 id="definition-3">Definition</h3>
 <p>Response type permissions limit the response types a client application is allowed to use when implementing an interactive flow like code, implicit or hybrid.</p>
 <h3 id="supported-permissions-3">Supported permissions</h3>

guide/getting-started.html

@@ -171,31 +171,26 @@ Here's an example for the client credentials grant, used in machine-to-machi
     // to replace the default OpenIddict entities.
     options.UseOpenIddict();
 });
-</code></pre></li>
+</code></pre><div class="WARNING"><h5>Warning</h5><p>Important: if you change the default entity primary key (e.g. to <code>int</code> or <code>Guid</code> instead of <code>string</code>), make sure you use the <code>options.ReplaceDefaultEntities&lt;TKey&gt;()</code>
-</ul>
+core extension accepting a <code>TKey</code> generic argument and use the generic <code>options.UseOpenIddict&lt;TKey&gt;()</code> overload to configure EF Core to use the specified type:</p>
-<p>-&gt; [!WARNING]
+<pre><code class="lang-csharp">services.AddOpenIddict()
--&gt; Important: if you change the default entity primary key (e.g. to <code>int</code> or <code>Guid</code> instead of <code>string</code>), make sure you use the <code>options.ReplaceDefaultEntities&lt;TKey&gt;()</code>
+    .AddCore(options =&gt;
--&gt; core extension accepting a <code>TKey</code> generic argument and use the generic <code>options.UseOpenIddict&lt;TKey&gt;()</code> overload to configure EF Core to use the specified type:
+    {
--&gt;
+        // Configure OpenIddict to use the default entities with a custom key type.
--&gt;    <code>csharp
+        options.UseEntityFrameworkCore()
--&gt;    services.AddOpenIddict()
+               .UseDbContext&lt;ApplicationDbContext&gt;()
--&gt;        .AddCore(options =&gt;
+               .ReplaceDefaultEntities&lt;Guid&gt;();
--&gt;        {
+    });
--&gt;            // Configure OpenIddict to use the default entities with a custom key type.
+
--&gt;            options.UseEntityFrameworkCore()
+services.AddDbContext&lt;ApplicationDbContext&gt;(options =&gt;
--&gt;                   .UseDbContext&lt;ApplicationDbContext&gt;()
+{
--&gt;                   .ReplaceDefaultEntities&lt;Guid&gt;();
+    // Configure the context to use Microsoft SQL Server.
--&gt;        });
+    options.UseSqlServer(configuration[&quot;Data:DefaultConnection:ConnectionString&quot;]);
--&gt;
+
--&gt;    services.AddDbContext&lt;ApplicationDbContext&gt;(options =&gt;
+    options.UseOpenIddict&lt;Guid&gt;();
--&gt;    {
+});
--&gt;        // Configure the context to use Microsoft SQL Server.
+</code></pre></div>
--&gt;        options.UseSqlServer(configuration[&quot;Data:DefaultConnection:ConnectionString&quot;]);
+</li>
--&gt;
--&gt;        options.UseOpenIddict&lt;Guid&gt;();
--&gt;    });
--&gt;</code></p>
-<ul>
 <li><p><strong>Create your own authorization controller:</strong>
 Implementing a custom authorization controller is required to allow OpenIddict to create tokens based on the identities and claims you provide.
 Here&#39;s an example for the client credentials grant:</p>

manifest.json

@@ -9,7 +9,7 @@
       "output": {
         ".html": {
           "relative_path": "configuration/application-permissions.html",
-          "hash": "T82L6dl/gd6zRNmoTwudtw=="
+          "hash": "a8OSMGZypwh8fbDrsgSY+A=="
         }
       },
       "is_incremental": false,
@@ -45,7 +45,7 @@
       "output": {
         ".html": {
           "relative_path": "guide/getting-started.html",
-          "hash": "PAK5Gf5at4cqxIPy5Io9pg=="
+          "hash": "lkMk8zUcxDGnyHX220VRdQ=="
         }
       },
       "is_incremental": false,