Adding comments for reasons overrides are used

private_dot_mozilla/private_firefox/private_personal-profile.default/user-overrides.js.tmpl

@@ -1,7 +1,6 @@
 /*
  *     name: Personal Arkenfox User.js Overrides
  *     date: 07 Jul 2023
- * modified: 07 Jul 2023
  */
 
 /*** [SECTION 0000]: CUSTOM UNDEFINED SETTINGS ***/
@@ -48,16 +47,19 @@ user_pref("browser.bookmarks.max_backups", 5);
 /* 0102: set startup page [SETUP-CHROME]
  * 0=blank, 1=home, 2=last visited page, 3=resume previous sessio
  * [SETTING] Home>New Windows and Tabs>Homepage and new windows ***/
+// Reason: I prefer loading my previous session of tabs
 user_pref("browser.startup.page", 3);
 
 /* 0103: set HOME+NEWWINDOW page
  * about:home=Firefox Home (default, see 0105), custom URL, about:blank
  * [SETTING] Home>New Windows and Tabs>Homepage and new windows ***/
+// Reason: Prefer firefox home/starter page (except sponsored, pocket, etc)
 user_pref("browser.startup.homepage", "about:home");
 
 /* 0104: set NEWTAB page
  * true=Firefox Home (default, see 0105), false=blank page
  * [SETTING] Home>New Windows and Tabs>New tabs ***/
+// Reason: Prefer firefox home/starter page (except sponsored, pocket, etc)
 user_pref("browser.newtabpage.enabled", true);
 
 
@@ -78,6 +80,7 @@ user_pref("keyword.enabled", true);
  * URL shortcuts use a cached randomly named .ico file which is stored in your
  * profile/shortcutCache directory. The .ico remains after the shortcut is deleted
  * If set to false then the shortcuts use a generic Firefox icon ***/
+// Reason: Prefer seeing actual favicons
 user_pref("browser.shell.shortcutFavicons", true);
 
 
@@ -92,6 +95,7 @@ user_pref("browser.shell.shortcutFavicons", true);
  * 0=always (default), 1=only if base domains match, 2=only if hosts match
  * [SETUP-WEB] Breakage: older modems/routers and some sites e.g banks, vimeo, icloud, instagram
  * If "2" is too strict, then override to "0" and use Smart Referer extension (Strict mode + add exceptions) ***/
+// Reason: Some sites don't work without this, may try 1
 user_pref("network.http.referer.XOriginPolicy", 0);
 
 
@@ -101,6 +105,7 @@ user_pref("network.http.referer.XOriginPolicy", 0);
  * [SETTING] General>DRM Content>Play DRM-controlled content
  * [TEST] https://bitmovin.com/demos/drm
  * [1] https://www.eff.org/deeplinks/2017/10/drms-dead-canary-how-we-just-lost-web-what-we-learned-it-and-what-we-need-do-next ***/
+// Reason: Breaks various streamingf sites
 user_pref("media.eme.enabled", true);
 
 
@@ -111,8 +116,11 @@ user_pref("media.eme.enabled", true);
  * [NOTE] If "history" is true, downloads will also be cleared
  * [NOTE] "sessions": Active Logins: refers to HTTP Basic Authentication [1], not logins via cookies
  * [1] https://en.wikipedia.org/wiki/Basic_access_authentication ***/
+// Reason: Prefer to not clear cache
 user_pref("privacy.clearOnShutdown.cache", false);     // [DEFAULT: true]
+// Reason: Prefer not to clear my history
 user_pref("privacy.clearOnShutdown.history", false);   // [DEFAULT: true]
+// Reason: Prefer to have my sessions restored
 user_pref("privacy.clearOnShutdown.sessions", false);  // [DEFAULT: true]
 
 
@@ -140,6 +148,13 @@ user_pref("privacy.clearOnShutdown.cookies", false); // Cookies
 
 
 /*** [SECTION 4500]: RFP (RESIST FINGERPRINTING)
+/* 4501: enable privacy.resistFingerprinting [FF41+]
+ * [SETUP-WEB] RFP can cause some website breakage: mainly canvas, use a site exception via the urlbar
+ * RFP also has a few side effects: mainly timezone is UTC0, and websites will prefer light theme
+ * [1] https://bugzilla.mozilla.org/418986 ***/
+// Reason: Still using the arkenfox setting, causes sites to be unable to detect system theme (dark vs light)
+// user_pref("privacy.resistFingerprinting", false);
+
 /* 4504: enable RFP letterboxing [FF67+]
  * Dynamically resizes the inner window by applying margins in stepped ranges [2]
  * If you use the dimension pref, then it will only apply those resolutions.
@@ -149,4 +164,6 @@ user_pref("privacy.clearOnShutdown.cookies", false); // Cookies
  * [WARNING] DO NOT USE: the dimension pref is only meant for testing
  * [1] https://bugzilla.mozilla.org/1407366
  * [2] https://hg.mozilla.org/mozilla-central/rev/6d2d7856e468#l2.32 ***/
+// Reason: Disabled as this really makes video players and sites take up much less space
+//         This is likely due to privacy.window.maxInnerWidth and Height needing to be manually set based on resolution
 user_pref("privacy.resistFingerprinting.letterboxing", false); // [HIDDEN PREF]