diff --git a/dot-atom/keymap.cson b/dot-atom/keymap.cson
index dea689c12..cc8a8228e 100644
--- a/dot-atom/keymap.cson
+++ b/dot-atom/keymap.cson
@@ -2,7 +2,8 @@
 #
 # Atom keymaps work similarly to style sheets. Just as style sheets use
 # selectors to apply styles to elements, Atom keymaps use selectors to associate
-# keystrokes with events in specific contexts.
+# keystrokes with events in specific contexts. Unlike style sheets however,
+# each selector can only be declared once.
 #
 # You can create a new keybinding in this file by typing "key" and then hitting
 # tab.
@@ -21,5 +22,6 @@
 # * https://atom.io/docs/latest/behind-atom-keymaps-in-depth
 #
 # This file uses CoffeeScript Object Notation (CSON).
-# If you are unfamiliar with CSON, you can read more about it here:
-# https://github.com/bevry/cson#what-is-cson
+# If you are unfamiliar with CSON, you can read more about it in the 
+# Atom Flight Manual:
+# https://atom.io/docs/latest/using-atom-basic-customization#cson
diff --git a/dot-atom/snippets.cson b/dot-atom/snippets.cson
index e27c1582f..eb8f1b22a 100644
--- a/dot-atom/snippets.cson
+++ b/dot-atom/snippets.cson
@@ -13,6 +13,9 @@
 #     'prefix': 'log'
 #     'body': 'console.log $1'
 #
+# Each scope (e.g. '.source.coffee' above) can only be declared once.
+#
 # This file uses CoffeeScript Object Notation (CSON).
-# If you are unfamiliar with CSON, you can read more about it here:
-# https://github.com/bevry/cson#what-is-cson
+# If you are unfamiliar with CSON, you can read more about it in the
+# Atom Flight Manual:
+# https://atom.io/docs/latest/using-atom-basic-customization#cson