diff --git a/1.3-Implementation.md b/1.3-Implementation.md index 413099d..19e3aa8 100644 --- a/1.3-Implementation.md +++ b/1.3-Implementation.md @@ -1,19 +1,12 @@ ### :small_orange_diamond: Before you do anything... +:star: Do not just take the `user.js` and use it as is. It's a template, treat it as such. Much has gone into making the defaults responsible and to not put anyone at risk. At worst, you will only get some inconvenience and breakage, and that's to be expected with a fairly hardened setup. Everyone's mileage will differ, and you can undo things that "break" (except deleted items: read this entire page). + - Read the [overview](https://github.com/ghacksuserjs/ghacks-user.js/wiki/1.1-Overview). It is important to understand how a `user.js` works with Firefox and what it can do. - Learn how to find and [back up](https://github.com/ghacksuserjs/ghacks-user.js/wiki/1.2-Backing-Up) your profile(s) - If you already have a `user.js`, consider using [Compare-UserJS](https://github.com/claustromaniac/Compare-UserJS), an excellent tool to compare user.js files and output the diffs in detailed breakdown - developed by our very own resident cat, [claustromaniac](https://github.com/claustromaniac) :cat2: -:star: Do not just take the `user.js` and use it as is. It's a template, treat it as such. Much has gone into making the defaults responsible and to not put anyone at risk. At worst, you will only get some inconvenience and breakage, and that's to be expected with a fairly hardened setup. Everyone's mileage will differ, and you can undo things that "break". - -### :small_orange_diamond: Tags - -While not 100% definitive, we have included `[SETUP*` tags for troubleshooting and setting up. Choose wisely, there is always a **trade-off**. Some examples - * `[SETUP-WEB]` can cause some websites to break - * `[SETUP-CHROME]` changes how Firefox itself behaves (i.e. NOT directly website related) - * `[SETUP-PERF]` may impact performance - -### :small_orange_diamond: Very important, check these first... +### :small_orange_diamond: At a bare minimum... :exclamation: ULTRA UBER IMPORTANT: Pay attention! @@ -45,10 +38,12 @@ While not 100% definitive, we have included `[SETUP*` tags for troubleshooting a :exclamation: QUITE IMPORTANT: Other preferences may cause site breakage, but nothing that can't be fixed. You won't "lose" anything...- it's not the end of the world. -- Search for `[SETUP` tags in the `user.js` +- While not 100% definitive, we have included `[SETUP*` tags for troubleshooting and setting up. Search for `[SETUP` tags in the `user.js`. Choose wisely, there is always a **trade-off**. Some examples + * `[SETUP-WEB]` can cause some websites to break + * `[SETUP-CHROME]` changes how Firefox itself behaves (i.e. NOT directly website related) + * `[SETUP-PERF]` may impact performance - There is a deprecated (section 9999) - * ESR users will want to switch on the relevant ESR section - * STABLE users will want to reset these prefs in about:config + * STABLE users can to reset these prefs in about:config ### :small_orange_diamond: Decide on a strategy...