diff --git a/Makefile.config.example b/Makefile.config.example
index b2fc6a5dd..193a94cde 100644
--- a/Makefile.config.example
+++ b/Makefile.config.example
@@ -1,6 +1,7 @@
 #
 # NetSurf build configuration example
 #
+#
 # To configure NetSurf's build options create a Makefile.config file. This is
 # an example Makefile.config.
 #
diff --git a/Makefile.defaults b/Makefile.defaults
index 4bfb17cae..dd5400647 100644
--- a/Makefile.defaults
+++ b/Makefile.defaults
@@ -1,13 +1,13 @@
 #
-# NetSurf default build configuration
+# NetSurf default build setup
 #
-# Some of these options support an 'AUTO' option, as well as YES and NO.
-# When an option is set to AUTO, the Makefile will attempt to detect if that
-# feature is available, enabling it if possible.
 #
-# Options marked "highly recommended" have a severe impact on NetSurf's
-# use as a web browser and should be set to YES unless there is a particularly
-# good reason not to.
+# | WARNING: You should NOT be editing this file.
+# |
+# |          If you want to configure your build, create a 'Makefile.config'
+# |          file with 'override' statements to override the settings here.
+# |          Follow the example in 'Makefile.config.example'.
+#
 #
 # This file should be treated as INVIOLATE and only altered to alter
 # the defaults by a core developer. If you wish to configure the build
@@ -18,6 +18,14 @@
 # Makefile.config can use the TARGET variable to control what to set
 # the configuration options to.
 #
+# Some of these options support an 'AUTO' option, as well as YES and NO.
+# When an option is set to AUTO, the Makefile will attempt to detect if that
+# feature is available, enabling it if possible.
+#
+# Options marked "highly recommended" have a severe impact on NetSurf's
+# use as a web browser and should be set to YES unless there is a particularly
+# good reason not to.
+#
 
 # ----------------------------------------------------------------------------
 # Options relating to all versions of NetSurf