diff --git a/docs/examples/1/sortspec.md b/docs/examples/1/sortspec.md
index b43009c..08c3dba 100644
--- a/docs/examples/1/sortspec.md
+++ b/docs/examples/1/sortspec.md
@@ -1,5 +1,13 @@
 ---
 sorting-spec: |
+ //
+ // A simple configuration for obsidian-custom-sort plugin
+ // (https://github.com/SebastianMC/obsidian-custom-sort)
+ // It causes the plugin to take over the control of the order of items in the root folder ('/') of the vault
+ // It explicitly sets the sorting to ascending ('<') alphabetical ('a-z')
+ // Folders and files are treated equally by the plugin (by default) so expect them intermixed
+ // after enabling the custom sort plugin
+ // 
  target-folder: /
  < a-z
 ---