From c9bc0ae38bbf5e5c705a074b3c5d69d8c1d02f3d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A1ra=20El-Saig?= <sara.el-saig@lombiq.com>
Date: Fri, 29 Dec 2023 14:35:17 +0100
Subject: [PATCH] Update documentation.

---
 Lombiq.HelpfulLibraries.OrchardCore/Docs/Security.md         | 5 +++++
 Lombiq.HelpfulLibraries.OrchardCore/Readme.md                | 1 +
 .../Security/OrchardCoreBuilderExtensions.cs                 | 3 +--
 3 files changed, 7 insertions(+), 2 deletions(-)
 create mode 100644 Lombiq.HelpfulLibraries.OrchardCore/Docs/Security.md

diff --git a/Lombiq.HelpfulLibraries.OrchardCore/Docs/Security.md b/Lombiq.HelpfulLibraries.OrchardCore/Docs/Security.md
new file mode 100644
index 00000000..48b099ca
--- /dev/null
+++ b/Lombiq.HelpfulLibraries.OrchardCore/Docs/Security.md
@@ -0,0 +1,5 @@
+# Lombiq Helpful Libraries - Orchard Core Libraries - Security
+
+## Extensions
+
+- `SecurityOrchardCoreBuilderExtensions`: Adds `BuilderExtensions` extensios. For example, the `ConfigureSecurityDefaults()` that provides some default security configuration for Orchard Core.
diff --git a/Lombiq.HelpfulLibraries.OrchardCore/Readme.md b/Lombiq.HelpfulLibraries.OrchardCore/Readme.md
index 3acfdd9c..fc5334f0 100644
--- a/Lombiq.HelpfulLibraries.OrchardCore/Readme.md
+++ b/Lombiq.HelpfulLibraries.OrchardCore/Readme.md
@@ -20,6 +20,7 @@ For general details about and on using the Helpful Libraries see the [root Readm
 - [Mvc](Docs/Mvc.md)
 - [Navigation](Docs/Navigation.md)
 - [ResourceManagement](Docs/ResourceManagement.md)
+- [Security](Docs/Security.md)
 - [Settings](Docs/Settings.md)
 - [Shapes](Docs/Shapes.md)
 - [TagHelpers](Docs/TagHelpers.md)
diff --git a/Lombiq.HelpfulLibraries.OrchardCore/Security/OrchardCoreBuilderExtensions.cs b/Lombiq.HelpfulLibraries.OrchardCore/Security/OrchardCoreBuilderExtensions.cs
index c5e4f8c1..76eb6bea 100644
--- a/Lombiq.HelpfulLibraries.OrchardCore/Security/OrchardCoreBuilderExtensions.cs
+++ b/Lombiq.HelpfulLibraries.OrchardCore/Security/OrchardCoreBuilderExtensions.cs
@@ -17,8 +17,7 @@ public static OrchardCoreBuilder ConfigureAntiForgeryAlwaysSecure(this OrchardCo
             services.Configure<AntiforgeryOptions>(options => options.Cookie.SecurePolicy = CookieSecurePolicy.Always));
 
     /// <summary>
-    /// Provides some default security configuration for Orchard Core. Use it in conjunction with <see
-    /// cref="SecurityApplicationBuilderExtensions.UseSecurityDefaults"/>.
+    /// Provides some default security configuration for Orchard Core.
     /// </summary>
     /// <remarks>
     /// <list type="bullet">