diff --git a/src/clj_jtwig/options.clj b/src/clj_jtwig/options.clj
index b20f52c..4f762fc 100644
--- a/src/clj_jtwig/options.clj
+++ b/src/clj_jtwig/options.clj
@@ -1,11 +1,13 @@
-(ns clj-jtwig.options)
+(ns clj-jtwig.options
+  "Options controlling certain behaviours of clj-jtwig. You should prefer to change these options through any
+   functions in clj-jtwig.core instead of directly modifying the values in the options map below.")
 
 ; global options
 (defonce options
   (atom
     {; true/false to enable/disable compiled template caching when using templates from
      ; files only. this does not affect templates being rendered directly from strings
-      :cache-compiled-templates true
+     :cache-compiled-templates         true
 
      ; true/false to enable/disable file status checks (existance of file and last modification
      ; date/time check). if true, these checks will be skipped ONLY if a compiled template for
@@ -17,4 +19,13 @@
      ; this option is intended to help increase performance when you know in advance that your
      ; templates will not be modified/deleted after they are first compiled and you want to skip
      ; any unnecessary file I/O.
-      :skip-file-status-checks  false}))
\ No newline at end of file
+     :skip-file-status-checks          false
+
+     ; true/false to enable/disable the web functions "stylesheet" and "javascript" support for
+     ; automatically checking for equivalent minified css/js files. If this is true, then when
+     ; these functions are called and passed a URL to a non-minified css/js file, the function
+     ; will check first to see if there is a '.min.js' or '.min.css' file with the same beginning
+     ; part of the filename, and if so use that file instead.
+     ; note that enabling this option does obviously incur a slight file I/O performance penalty
+     ; whenever these functions are used
+     :check-for-minified-web-resources true}))
\ No newline at end of file