0425: passive TP

https://github.com/ghacksuserjs/ghacks-user.js/issues/144#issuecomment-321980962
https://github.com/ghacksuserjs/ghacks-user.js/issues/144#issuecomment-322903835

.gitattributes

@@ -0,0 +1,8 @@
+* text=auto
+
+*.js text
+*.md text
+*.yml text
+*.txt text
+
+*.png binary

README.md

@@ -1,48 +1,37 @@
-## ghacks-user.js
+### ![](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/wikipiki/bullet01.png) user.js
+A `user.js` is a configuration file that can control hundreds of Firefox settings. For a more technical breakdown and explanation, you can read more on the [overview](https://github.com/ghacksuserjs/ghacks-user.js/wiki/1.1-Overview) wiki page.
 
-- This is a rough draft, please read the old intro currently at the start of the user.js in the meantime.
+### ![](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/wikipiki/bullet01.png) ghacks user.js
-- Paragraph here about not jumping in without reading first, and backing up, and understanding the changes
+The [ghacks user.js](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/user.js) is a template, which, as provided, aims (![](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/wikipiki/exclamation.png) with [add-ons](https://github.com/ghacksuserjs/ghacks-user.js/wiki/Appendix-B:-Firefox-Add-ons) <sup>1</sup> ) to provide as much privacy and enhanced security as possible, and to reduce tracking and fingerprinting as much as possible - while minimizing any loss of functionality and breakage (but it will happen).
 
-### Origins
+We aim to INFORM and give you CHOICES. No one size fits all, so customize it! And not all sites have the same requirements, so use [profiles](https://github.com/ghacksuserjs/ghacks-user.js/wiki/2.3-Concurrent-Profiles) with custom versions. We won't set you wrong.
-- yada yada
 
-### Purpose
+INFORMATION IS POWER. So you can make informed decisions to better protect yourself online, we aim to be:
-- discuss why use a js (enforcement on startup, migration)
-- outline trade-offs between security vs privacy etc
-- explain expectations and site breakage
-- explain this version is a "compromise" or balance that aims (with addons eg you WILL need uBlock Origin or turn safe browsing and tracking protection back on) to provide as much privacy and enhanced security as possible, and to reduce the fingerpritning attack surface as much as possible - while putting up with some incoveniences and as little site breakage as possible (but it will happen). It's only a starting point.
-- provide troubleshooting: site breakage will happen. 90=% of the preferences cause no issues. It is only a small core of settings that people may or may not need to look at, depending on their objective.
-- no one size fits all, this is a template, fork it! Customize it! (see goals, we won't set you wrong)
 
+* Accessible (provide information and simpler, less-technical descriptions if possible)
+* Accountable (provide reputable references/sources, [test sites](https://github.com/ghacksuserjs/ghacks-user.js/wiki/Appendix-C:-Test-Sites), dispel bad advice)
+* Change trackable (yay! we're on github now, with commits)
+* Compatible (including a [deprecated section](https://github.com/ghacksuserjs/ghacks-user.js/issues/123), [releases](https://github.com/ghacksuserjs/ghacks-user.js/releases))
+* Comprehensive (including enforcing defaults and future-proofing)
+* Current and up-to-date with stable (including [changelogs](https://github.com/ghacksuserjs/ghacks-user.js/search?q=label%3Achangelog&type=Issues&utf8=%E2%9C%93))
+* Detailed (preference versioning, hidden preference information, explanations, and more)
+* Easy to use and discuss (sections, sub-sections, numbering)
+* Helpful (including a [wiki](https://github.com/ghacksuserjs/ghacks-user.js/wiki) with features such as [add-ons](https://github.com/ghacksuserjs/ghacks-user.js/wiki/Appendix-B:-Firefox-Add-ons), [user scripts](https://github.com/ghacksuserjs/ghacks-user.js/wiki/3.1-User-Scripts), [references](https://github.com/ghacksuserjs/ghacks-user.js/wiki/Appendix-D:-References) and more)
+* Innovative (formatting, special tags, and future plans such as branches)
 
-### Goals & Standards
+### ![](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/wikipiki/bullet01.png) usage
-To be **THE** template and resource all other user.js' come to for news, links, information and more, which means it needs to be:
+Everyone, experts included, should at least read the [implementation](https://github.com/ghacksuserjs/ghacks-user.js/wiki/1.3-Implementation) wiki page, as it contains important information regarding a few default settings we use. The rest of the [wiki](https://github.com/ghacksuserjs/ghacks-user.js/wiki) is helpful as well.
 
-- comprehensive (eg some prefs are included at default for completeness/enforcement, a lot are included and changed for future-proofing, etc)
+### ![](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/wikipiki/bullet01.png) acknowledgments
-- current and available and change-trackable (hey, we're on github now)
+Literally thousands of sources, references and suggestions. That said...
-- easy to understand (good, simple, less-technincal descriptions)
-- accountable and a resource (lots of links to authorative authors and tech papers, also repo wiki)
-- correct and to dispell myths and bad advise (see accountable)
-- eassy to follow and report and discuss (logical and numbered structure)
-- give good advise (see trade-offs)
-- expanded on with more information, such as FF version numbering for introduction and deprecation of preferences, hidden pref tags etc
-- archived for each stable release (starting with 51)
-- to provide illustrated wiki topics to help (help wanted please!)
-- to make it as easy as possible for anyone to use a user.js and get it right for them
-- to provide two or three future forks with differnent settings from "painless no-breakage no-addons" thru to a "super-hardened" version: for use with multiple profiles
 
-### Implementation
+* Martin Brinkmann at [ghacks](https://www.ghacks.net/) <sup>2</sup>
-- expectations of the user
+   * 100% genuine super-nice all-round good guy
-- link to wiki on testing and tweaking in a portable FF first
+* The ghacks community and commentators
-- backup first: link to wiki article on backup & restore methods
+   * Special mentions to [earthlng](https://github.com/earthlng), Tom Hawack, Just me, Conker, Rockin’ Jerry, Ainatar, Parker Lewis
-- changing, resetting preferences: user.js and about:config
+* [12bytes](http://12bytes.org/articles/tech/firefoxgecko-configuration-guide-for-privacy-and-performance-buffs)
+   * The 12bytes article now uses this user.js and supplements it with an additonal JS hosted right [here](https://github.com/atomGit/Firefox-user.js) at github
 
-### Troubleshooting
+<sup>1</sup> ![](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/wikipiki/exclamation.png) Important: We HIGHLY recommend using uBlock Origin, uMatrix and a cookie extension. Section 0400, if modified, allows Tracking Protection and Safe Browsing to be disabled. Do this at your own risk. See the [implementation](https://github.com/ghacksuserjs/ghacks-user.js/wiki/1.3-Implementation) wiki page for more.
-- wiki links
-
-### Help & Resources
-- wiki links, appendices etc
-
-### Acknowledgements
-- yada yada
 
+<sup>2</sup> The ghacks user.js was an independent project by [Thorin-Oakenpants](https://github.com/Thorin-Oakenpants) started in early 2015 and was [first published](https://www.ghacks.net/2015/08/18/a-comprehensive-list-of-firefox-privacy-and-security-settings/) at ghacks in August 2015. It was kept up-to-date and expanded by the original author with three major updates and articles. With Martin Brinkmann's blessing, it will keep the ghacks name.