From f128f0a029430cb5ab4f89733d8297666a6b2fdf Mon Sep 17 00:00:00 2001
From: "Gabriel A. Giovanini" <mail@gabrielgio.me>
Date: Fri, 13 Dec 2024 17:56:57 +0100
Subject: docs: Add more documentation to the config example

---
 config.example.scfg | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/config.example.scfg b/config.example.scfg
index 5c3e5e4..59a04ad 100644
--- a/config.example.scfg
+++ b/config.example.scfg
@@ -3,11 +3,26 @@
 listen-addr unix://var/run/cerrado.sock
 
 root-readme /srv/git/README.md
+syntax-highlight monokailight
+
+# if passphrase is empty the whole authentication, private/public repository
+# and login UI will be disabled, and only public repository will be displayed.
 passphrase $2a$14$VnB/ZcB1DUDkMnosRA6Y7.dj8h5eroslDxTeXlLwfQX/x86mh6WAq
 aes-key 8XHptZxSWCGs1m7QzztX5zNQ7D9NiQevVX0DaUTNMbDpRwFzoJiB0U7K6O/kqIt01jJVgzBUfiR8ES46ZLLb4w==
-syntax-highlight monokailight
 
+# repository section is order dependent where the first repository has priority
+# in case of conflict. Repository has also priority over scan. The order
+# between scan and repository is irrelevant which means that all repository
+# sections will be read first then all the scans.
+repository /srv/git/cerrado.git {
+    name cerrado
+    description "Self host single person forge"
+    public true
+}
 
+# scan is order dependent where first scan has priority in case of conflict. So
+# if you add another scan section bellow that scan the same folders it will be
+# ignored.
 scan /srv/git/private {
     public false
 }
@@ -16,13 +31,6 @@ scan /srv/git/ {
     public true
 }
 
-
-repository /srv/git/cerrado.git {
-    name cerrado
-    description "Self host single person forge"
-    public true
-}
-
 # TBD
 #user admin:iKlvHe1g0UoXE
 #
-- 
cgit v1.2.3