Git/firefox-user.js
1
0
Fork 0
mirror of https://github.com/arkenfox/user.js.git synced 2024-11-27 21:06:56 +01:00
Code Issues Packages Projects Releases Wiki Activity

Updated 1.3 Implementation (markdown)

Thorin-Oakenpants 2019-04-19 04:08:13 +00:00
parent ba80402b2c
commit 20fece12ec
1 changed files with 8 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
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...