diff --git a/www/docs/customization/release.md b/www/docs/customization/release.md
index d6f3ad538..01ec65eb3 100644
--- a/www/docs/customization/release.md
+++ b/www/docs/customization/release.md
@@ -157,11 +157,15 @@ changelog:
   # Set it to true if you wish to skip the changelog generation.
   # This may result in an empty release notes on GitHub/GitLab/Gitea.
   skip: true
-  # could either be asc, desc or empty
+
+  # Sorts the changelog by the commit's messages.
+  # Could either be asc, desc or empty
   # Default is empty
   sort: asc
+
   filters:
-    # commit messages matching the regexp listed here will be removed from
+
+    # Commit messages matching the regexp listed here will be removed from
     # the changelog
     # Default is empty
     exclude: