diff --git a/configs/development.ini b/configs/development.ini
--- a/configs/development.ini
+++ b/configs/development.ini
@@ -51,7 +51,7 @@ asyncore_use_poll = true
 ; Process name visible in process list
 #proc_name = rhodecode_vcsserver
 
-; Type of worker class, one of sync, gevent
+; Type of worker class, one of `sync`, `gevent`
 ; currently `sync` is the only option allowed.
 #worker_class = sync
 
@@ -166,13 +166,13 @@ rc_cache.repo_object.backend = dogpile.c
 ; Examples: 86400 (1Day), 604800 (7Days), 1209600 (14Days), 2592000 (30days), 7776000 (90Days)
 rc_cache.repo_object.expiration_time = 2592000
 
-; cache file store path, defaults to temporary directory if not set
+; file cache store path. Defaults to `cache_dir =` value or tempdir if both values are not set
 #rc_cache.repo_object.arguments.filename = /tmp/vcsserver_cache.db
 
-; **********************************************************
+; ***********************************************************
 ; `repo_object` cache with redis backend
-; recommended for larger instance, or for better performance
-; **********************************************************
+; recommended for larger instance, and for better performance
+; ***********************************************************
 
 ; `repo_object` cache settings for vcs methods for repositories
 #rc_cache.repo_object.backend = dogpile.cache.rc.redis_msgpack
diff --git a/configs/production.ini b/configs/production.ini
--- a/configs/production.ini
+++ b/configs/production.ini
@@ -34,7 +34,7 @@ loglevel = info
 ; Process name visible in process list
 proc_name = rhodecode_vcsserver
 
-; Type of worker class, one of sync, gevent
+; Type of worker class, one of `sync`, `gevent`
 ; currently `sync` is the only option allowed.
 worker_class = sync
 
@@ -129,13 +129,13 @@ rc_cache.repo_object.backend = dogpile.c
 ; Examples: 86400 (1Day), 604800 (7Days), 1209600 (14Days), 2592000 (30days), 7776000 (90Days)
 rc_cache.repo_object.expiration_time = 2592000
 
-; cache file store path, defaults to temporary directory if not set
+; file cache store path. Defaults to `cache_dir =` value or tempdir if both values are not set
 #rc_cache.repo_object.arguments.filename = /tmp/vcsserver_cache.db
 
-; **********************************************************
+; ***********************************************************
 ; `repo_object` cache with redis backend
-; recommended for larger instance, or for better performance
-; **********************************************************
+; recommended for larger instance, and for better performance
+; ***********************************************************
 
 ; `repo_object` cache settings for vcs methods for repositories
 #rc_cache.repo_object.backend = dogpile.cache.rc.redis_msgpack