firefox: add comments describing settings

firefox/base_configuration.js

@@ -1,38 +1,38 @@
-user_pref("app.normandy.enabled", false);
-user_pref("browser.aboutConfig.showWarning", false);
-user_pref("browser.backspace_action", 0);
-user_pref("browser.contentblocking.category", "strict");
-user_pref("browser.ctrlTab.sortByRecentlyUsed", false);
-user_pref("browser.formfill.enable", false);
-user_pref("browser.messaging-system.whatsNewPanel.enabled", false);
-user_pref("browser.newtabpage.activity-stream.asrouter.userprefs.cfr.addons", false);
-user_pref("browser.newtabpage.activity-stream.asrouter.userprefs.cfr.features", false);
-user_pref("browser.newtabpage.enabled", false);
-user_pref("browser.privatebrowsing.vpnpromourl", "");
-user_pref("browser.safebrowsing.blockedURIs.enabled", false);
-user_pref("browser.safebrowsing.downloads.enabled", false);
-user_pref("browser.safebrowsing.malware.enabled", false);
-user_pref("browser.safebrowsing.phishing.enabled", false);
-user_pref("browser.search.suggest.enabled", false);
-user_pref("browser.slowStartup.notificationDisabled", true);
-user_pref("browser.startup.homepage", "about:profiles");
-user_pref("browser.urlbar.suggest.quicksuggest", false);
-user_pref("datareporting.healthreport.uploadEnabled", false);
-user_pref("devtools.selfxss.count", 5);
-user_pref("devtools.whatsnew.enabled", false);
-user_pref("devtools.whatsnew.feature-enabled", false);
-user_pref("dom.security.https_only_mode", true);
-user_pref("extensions.formautofill.creditCards.enabled", false);
-user_pref("extensions.privatebrowsing.notification", true);
-user_pref("geo.enabled", false);
-user_pref("identity.fxaccounts.enabled", false);
-user_pref("layout.css.visited_links_enabled", false);
-user_pref("media.autoplay.default", 5);
-user_pref("network.dns.disablePrefetch", true);
-user_pref("network.predictor.enabled", false);
-user_pref("network.prefetch-next", false);
-user_pref("network.trr.mode", 5);
-user_pref("privacy.history.custom", true);
-user_pref("security.OCSP.enabled", 0);
-user_pref("signon.rememberSignons", false);
-user_pref("view_source.wrap_long_lines", true);
+user_pref("app.normandy.enabled", false); // Disable Normandy studies
+user_pref("browser.aboutConfig.showWarning", false); // Disable warning when viewing about:config settings
+user_pref("browser.backspace_action", 0); // Make backspace key navigate back
+user_pref("browser.contentblocking.category", "strict"); // Enable strict blocking
+user_pref("browser.ctrlTab.sortByRecentlyUsed", false); // Make Ctrl-Tab navigate through tabs in current order, not recently used order
+user_pref("browser.formfill.enable", false); // Disable form autofill
+user_pref("browser.messaging-system.whatsNewPanel.enabled", false); // Disable What's New description
+user_pref("browser.newtabpage.activity-stream.asrouter.userprefs.cfr.addons", false); // Disable add-on recommendations
+user_pref("browser.newtabpage.activity-stream.asrouter.userprefs.cfr.features", false); // Disable feature recommendations
+user_pref("browser.newtabpage.enabled", false); // Disable new tab page
+user_pref("browser.privatebrowsing.vpnpromourl", ""); // Disable VPN promo link in private tabs
+user_pref("browser.safebrowsing.blockedURIs.enabled", false); // Disable plugin stability protection
+user_pref("browser.safebrowsing.downloads.enabled", false); // Disable download protection
+user_pref("browser.safebrowsing.malware.enabled", false); // Disable malware protection
+user_pref("browser.safebrowsing.phishing.enabled", false); // Disable phishing protection
+user_pref("browser.search.suggest.enabled", false); // Disable search suggestions
+user_pref("browser.slowStartup.notificationDisabled", true); // Disable slow startup notifications
+user_pref("browser.startup.homepage", "about:profiles"); // Set homepage to about:profile page
+user_pref("browser.urlbar.suggest.quicksuggest", false); // Disable contextual suggestions in address bar
+user_pref("datareporting.healthreport.uploadEnabled", false); // Disable submitting health report
+user_pref("devtools.selfxss.count", 5); // Disable protections against pasting into console
+user_pref("devtools.whatsnew.enabled", false); // Disable What's New in dev tools
+user_pref("devtools.whatsnew.feature-enabled", false); // Disable What's New in dev tools
+user_pref("dom.security.https_only_mode", true); // Enable HTTPS-only mode
+user_pref("extensions.formautofill.creditCards.enabled", false); // Do not offer to remember payment information
+user_pref("extensions.privatebrowsing.notification", true); // Dismiss notification about extensions in private browser windows
+user_pref("geo.enabled", false); // Disable geolocation
+user_pref("identity.fxaccounts.enabled", false); // Disable Firefox account features
+user_pref("layout.css.visited_links_enabled", false); // Disable styling of visited links
+user_pref("media.autoplay.default", 5); // Disable autoplay of all media
+user_pref("network.dns.disablePrefetch", true); // Disable DNS prefetching
+user_pref("network.predictor.enabled", false); // Disable network predictor
+user_pref("network.prefetch-next", false); // Disable link prefetching
+user_pref("network.trr.mode", 5); // Disable DNS-over-HTTPS
+user_pref("privacy.history.custom", true); // Enable custom history settings
+user_pref("security.OCSP.enabled", 0); // Disable OCSP certificate revocation checks
+user_pref("signon.rememberSignons", false); // Do not offer to remember logins
+user_pref("view_source.wrap_long_lines", true); // Wrap long lines in View Source

firefox/delete_cookies.js

@@ -1 +1 @@
-user_pref("network.cookie.lifetimePolicy", 2);
+user_pref("network.cookie.lifetimePolicy", 2); // Delete cookies when closing browser

firefox/disable_history.js

@@ -1 +1 @@
-user_pref("places.history.enabled", false);
+user_pref("places.history.enabled", false); // Disable remembering of browsing and download history

firefox/preserve_session.js

@@ -1 +1 @@
-user_pref("browser.startup.page", 3);
+user_pref("browser.startup.page", 3); // Restore previous session on startup