From ceb46788a629a4fb36ab218496c0c4f143fffff8 Mon Sep 17 00:00:00 2001
From: HJ <11689349+yokoffing@users.noreply.github.com>
Date: Sat, 19 Aug 2023 14:05:41 -0400
Subject: [PATCH] Updated Overrides (markdown)

---
 Overrides.md | 121 +++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 113 insertions(+), 8 deletions(-)

diff --git a/Overrides.md b/Overrides.md
index de154a5..a080c66 100644
--- a/Overrides.md
+++ b/Overrides.md
@@ -1,10 +1,115 @@
-See [Common Overrides sticky](https://github.com/yokoffing/Betterfox/issues/87).
+## Instructions
+To re-enable certain functions, copy+paste the appropriate prefs to the `MY OVERRIDES` section of your `user.js`.
 
-Apply preferences from the [common overrides](https://github.com/yokoffing/Betterfox/issues/87) sticky to adjust the following behavior:
-* Firefox **Accessibility Service** is disabled to improve resource utilization and security. Override this if you use assistive software.
-* **Firefox Sync** and **Firefox View** are disabled. Override if you use these features.
-* The built-in **password manager** is disabled. We recommend using [Bitwarden](https://addons.mozilla.org/en-US/firefox/addon/bitwarden-password-manager/) or [1Password](https://addons.mozilla.org/en-US/firefox/addon/1password-x-password-manager) to manage your credentials on multiple devices.
-* **Top sites** (pinned site shortcuts) are removed for a clean new tab page.
-* **Location requests** and **site notifications** are blocked to minimize annoyances.
+![Screenshot 2022-10-17 193626](https://user-images.githubusercontent.com/11689349/196305458-ffb9e811-f8d3-4311-802b-a7bfc2c7d411.png)
 
-You can easily adjust these by [copying and pasting](https://github.com/yokoffing/Betterfox/issues/87) preferences to your personal file. :thumbsup:
+A `user.js` applies prefs in the order they are written.
+
+So, if a pref is listed a second time, then the second value (yours) would override the first (Betterfox's).
+
+***
+
+## Accessibility Service
+Firefox **Accessibility Service** is disabled to improve resource utilization and security.
+
+This will allow for external applications to use keyboard shortcuts, as well as allow screen readers and other assistive software.
+```
+// PREF: restore Accessibility Service
+user_pref("accessibility.force_disabled", 0);
+```
+
+***
+
+## Firefox Sync & View
+**Firefox Sync** and **Firefox View** are disabled to minimize connections.
+
+Enable Sync functionality without enabling the View UI, if desired.
+```
+// PREF: restore Firefox accounts
+user_pref("identity.fxaccounts.enabled", true);
+
+// PREF: restore Firefox View UI
+user_pref("browser.tabs.firefox-view", true);
+```
+
+***
+
+## Password, credit card, and address management
+The built-in **password manager** is disabled for security.
+
+We recommend using [Bitwarden](https://addons.mozilla.org/en-US/firefox/addon/bitwarden-password-manager/) or [1Password](https://addons.mozilla.org/en-US/firefox/addon/1password-x-password-manager) to manage your credentials on multiple devices.
+```
+// PREF: restore login manager and autofill
+user_pref("signon.rememberSignons", true);
+
+// PREF: restore address and credit card manager
+user_pref("extensions.formautofill.addresses.enabled", true);
+user_pref("extensions.formautofill.creditCards.enabled", true);
+
+// PREF: disable capturing credentials in private browsing windows
+user_pref("signon.privateBrowsingCapture.enabled", false);
+```
+
+***
+
+## Search engine suggestions
+**Search engine suggestions** are disabled in the URL bar to keep everything you type from going to Google.
+
+You can still use search buttons and [bookmark keywords](https://support.mozilla.org/en-US/kb/how-search-from-address-bar) (example: [article](https://www-archive.mozilla.org/docs/end-user/keywords.html) | [video](https://youtu.be/bGTBH9yr8uw?t=968)). 
+```
+// PREF: restore search engine suggestions
+user_pref("browser.search.suggest.enabled", false);
+//user_pref("browser.search.suggest.enabled.private", false); // DEFAULT
+```
+
+***
+
+## Pinned Shortcuts on New Tab page
+**Top sites** (pinned site shortcuts) are removed for a clean new tab page.
+```
+// PREF: restore Top Sites on New Tab page and remove sponsored content
+user_pref("browser.newtabpage.activity-stream.feeds.topsites", true); // Shortcuts
+user_pref("browser.newtabpage.activity-stream.showSponsoredTopSites", false); // Sponsored shortcuts 
+user_pref("browser.newtabpage.activity-stream.feeds.section.topstories", false); // Recommended by Pocket
+user_pref("browser.newtabpage.activity-stream.showSponsored", false); // Sponsored Stories
+```
+
+***
+
+## Location requests
+**Location requests** are blocked to minimize annoyances.
+```
+// PREF: allow websites to ask you for your location
+user_pref("permissions.default.geo", 0);
+```
+
+***
+
+## Site notifications
+**Site notifications** are blocked to minimize annoyances.
+```
+// PREF: allow websites to ask you to receive site notifications
+user_pref("permissions.default.desktop-notification", 0);
+```
+
+***
+
+# Possible error codes
+
+## SSL negotiation
+Override if you experience error `SSL_ERROR_UNSAFE_NEGOTIATION` from a **trusted** site.
+```
+// PREF: allow unsafe SSL negotiation
+// [ERROR] SSL_ERROR_UNSAFE_NEGOTIATION
+user_pref("security.ssl.require_safe_negotiation", false);
+```
+
+***
+
+## Public Key Pinning (PKP)
+We enforce [strict pinning](https://github.com/yokoffing/Betterfox/blob/94c4a77f0ca1c868c4b2f02360dbdbefb7789bd5/Securefox.js#L241-L247). Override if you have issues with antivirus showing `MOZILLA_PKIX_ERROR_KEY_PINNING_FAILURE`.
+```
+// PREF: relax certificate pinning (PKP)
+// [ERROR] MOZILLA_PKIX_ERROR_KEY_PINNING_FAILURE
+user_pref("security.cert_pinning.enforcement_level", 1);
+```