chore: update wording for example config comments

Signed-off-by: NotAShelf <raf@notashelf.dev>
Change-Id: If5d8db30bc8b877e462a1a2d2fa5f6206a6a6964

pinakes.example.toml

@@ -21,18 +21,17 @@ path = "pinakes.db"
 # database = "pinakes"
 # username = "pinakes"
 # password = "your_secure_password_here"
-# # Maximum number of database connections in the pool
+## Maximum number of database connections in the pool
 # max_connections = 10
-# # Enable TLS/SSL for database connections
-# # tls = { mode = "require", ca_cert = "/path/to/ca.pem" }
+## Enable TLS/SSL for database connections
+# tls = { mode = "require", ca_cert = "/path/to/ca.pem" }
 
 ## Directory Configuration
 [directories]
 # Root directories to scan for media files
 # Supports environment variable expansion: ${HOME}, $HOME
-# Paths can be absolute or relative to the working directory.
-# Add more directories as needed.
-
+# Paths can be absolute or relative to the working directory. Add more directories
+# as needed.
 roots = [
   "${HOME}/Music",
   "${HOME}/Documents",
@@ -45,6 +44,7 @@ roots = [
 [scanning]
 # Watch directories for changes using filesystem events
 # When enabled, Pinakes will automatically detect new/modified/deleted files
+# and update the catalog index.
 # Default: true
 watch = true
 
@@ -109,9 +109,9 @@ port = 3000
 ## Photo Management Configuration
 # These settings control CPU-intensive photo processing features
 [photos]
-# Generate perceptual hashes for image duplicate detection
-# Uses DCT (Discrete Cosine Transform) algorithm
-# CPU-intensive but enables finding visually similar images
+# Generate perceptual hashes for image duplicate detection. Uses the
+# DCT (Discrete Cosine Transform) algorithm, which is CPU-intensive, but
+# enables finding visually similar images (mostly) accurately.
 # Default: true
 generate_perceptual_hash = true
 
@@ -273,6 +273,8 @@ enabled = false
 # directory = "~/.local/share/pinakes/plugins"
 
 # Enable plugin system (experimental)
+# NOTE: The plugin system has not been finalized, and the API is subject to change.
+# Please report any bugs, and expect breaking changes.
 # Default: false
 # enabled = false