--- a/modules/libpref/init/StaticPrefList.h
+++ b/modules/libpref/init/StaticPrefList.h
@@ -9,18 +9,20 @@
 //
 // If a pref is listed here and also in a prefs data file such as all.js, the
 // value from the latter will override the value given here. For vanilla
 // browser builds such overrides are discouraged, but they are necessary for
 // some configurations (e.g. Thunderbird).
 //
 // The file is separated into sections, where the sections are determined by
 // the first segment of the prefnames within (e.g. "network.predictor.enabled"
-// is within the "Network" section). Sections should be kept in alphabetical
+// is within the "Network" section). Sections must be kept in alphabetical
 // order, but prefs within sections need not be.
+// Please follow the existing naming convention when considering adding a new
+// pref and whether you need a new section.
 //
 // Normal prefs
 // ------------
 // Definitions of normal prefs in this file have the following form.
 //
 //   PREF(<pref-name-string>, <cpp-type>, <default-value>)
 //
 // - <pref-name-string> is the name of the pref, as it appears in about:config.