diff --git a/src/stdlib/settings.coffee b/src/stdlib/settings.coffee
index 869ed4813..553027fb4 100644
--- a/src/stdlib/settings.coffee
+++ b/src/stdlib/settings.coffee
@@ -1,6 +1,18 @@
 fs = require 'fs'
 {CoffeeScript} = require 'coffee-script'
 
+# Settings file looks like:
+#     editor: # name of class
+#       theme: "twilight"
+#       tabSize: 2
+#       softTabs: true
+#       showInvisibles: false
+#
+#     project:
+#       ignorePattern: /x|y|z/
+#
+# Settings are applied to object x's settings variable by calling applyTo(x) on
+# instance of Settings.
 module.exports =
 class Settings
   settings: {}