diff --git a/private/README.md b/private/README.md
index eb15ddb8a..a370d34b3 100644
--- a/private/README.md
+++ b/private/README.md
@@ -5,14 +5,17 @@ where to store your private configuration layers.
 
 To create a new configuration layer:
 
-`<SPC> : config-system/create-layer` RET
+    `<SPC> : config-system/create-layer RET`
 
-Then enter the name of your contribution in the prompt.
+Then enter the name of your configuration in the prompt.
 
 A directory named after the created configuration layer will be created here
-along with template files within it.
+along with template files within it (packages.el and extensions.el, more info
+on the meaning of those files can be found in the [documentation][conf_layers]).
 
-Each file has further guidance written in them.
+Each created file has further guidance written in them.
 
 Once the configuration is done, restart Emacs to load, install and configure
 your layer.
+
+[conf_layers]: https://github.com/syl20bnr/spacemacs/blob/master/DOCUMENTATION.md#extensions-and-packages