diff --git a/config_entity_example/config/install/config_entity_example.robot.marvin.yml b/config_entity_example/config/install/config_entity_example.robot.marvin.yml
index d5e0430..1a7b152 100644
--- a/config_entity_example/config/install/config_entity_example.robot.marvin.yml
+++ b/config_entity_example/config/install/config_entity_example.robot.marvin.yml
@@ -1,9 +1,14 @@
 # This file defines a default config entity. This allows the module to include
-# config entities that are present 'out of the box'.
-# These can be edited by the user. The modified version is saved to the site
-# config folder, which this original copy remains untouched.
+# config entities that are present 'out of the box'. Default config entities
+# are created in Drupal when the module is enabled. They are removed when the
+# module is uninstalled.
 
-# For this system to work, we have to define our config schema in
+# Default config entities can be edited by the user within Drupal. This edited
+# entity wil become exportable through the configuration system. This file,
+# however, will remain untouched.
+
+# For our config entity to be added at installation time, we have to place it in
+# the config/install directory of our module. Thus our file is located at:
 # config/install/config_entity_example.robot.marvin.yml.
 
 # You can see where these properties are defined in the annotation of
diff --git a/config_entity_example/config/schema/config_entity_example.schema.yml b/config_entity_example/config/schema/config_entity_example.schema.yml
index 38fcdce..aeef9e0 100644
--- a/config_entity_example/config/schema/config_entity_example.schema.yml
+++ b/config_entity_example/config/schema/config_entity_example.schema.yml
@@ -4,6 +4,9 @@
 # See for example the file config/config_entity_example.robot.marvin.yml, which
 # contains our default config entity.
 
+# Documentation for schema files like this one is located here:
+# https://drupal.org/node/1905070
+
 config_entity_example.robot.*:
   type: mapping
   label: 'Robot'