From f19d42279d277cbc941504bd70ae80cfa2333c79 Mon Sep 17 00:00:00 2001 From: "Collin M. Barrett" Date: Wed, 21 Feb 2018 19:45:17 -0600 Subject: [PATCH] combine About and README, update contents --- .github/README.md | 50 +++++++++++++++++++++++++++++++++++++++++------ About.md | 40 ------------------------------------- 2 files changed, 44 insertions(+), 46 deletions(-) delete mode 100644 About.md diff --git a/.github/README.md b/.github/README.md index 5985222e1..5e539bdfb 100644 --- a/.github/README.md +++ b/.github/README.md @@ -4,15 +4,53 @@ [![Travis](https://img.shields.io/travis/collinbarrett/FilterLists.svg?label=travis)](https://travis-ci.org/collinbarrett/FilterLists) [![License](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/collinbarrett/FilterLists/blob/master/LICENSE) -FilterLists is the independent, comprehensive directory of filter and host lists for advertisements, trackers, malware, and annoyances. [Learn More](https://github.com/collinbarrett/FilterLists/blob/master/About.md). +FilterLists is the independent, comprehensive directory of filter and host lists for advertisements, trackers, malware, and annoyances. ## Links -| Site | API | -| --------------------------------------------------- | ------------------------------------------------- | -| [v3 (Beta)](https://filterlists.com/) | [v1 (Beta)](https://filterlists.com/api/v1/lists)| -| [v2 (Legacy, Frozen)](https://v2.filterlists.com/) | | -| [v1 (Legacy, Frozen)](https://v1.filterlists.com/) | | +| Site | API | +| --------------------------------------------------- | ------------------------------------------------------ | +| [v3 (Live, Beta)](https://filterlists.com/) | [v1 (Live, Beta)](https://filterlists.com/api/v1/lists)| +| [v2 (Legacy, Frozen)](https://v2.filterlists.com/) | | +| [v1 (Legacy, Frozen)](https://v1.filterlists.com/) | | ## Adding or Updating Lists To submit a new list or update data about an existing list, please submit a pull request to [data](https://github.com/collinbarrett/FilterLists/tree/master/data) in conjunction with the data model described [here](https://github.com/collinbarrett/FilterLists/wiki/Data-Model_sidebar). Alternatively, you can [open a new issue](https://github.com/collinbarrett/FilterLists/issues/new) providing information for all of the fields described in the [data model](https://github.com/collinbarrett/FilterLists/wiki/Data-Model_sidebar). + +## Adding or Updating Rules + +FilterLists does not maintain any of these lists. It serves only as a discovery tool to direct users to lists that they may want to use. If you want to request addition, modification, or removal of a rule from a list, you will need to contact the maintainers of that list directly. FilterLists provides a variety of ways you can get in contact with the maintainers to do so. + +## Background + +FilterLists helps to protect your privacy and security when using the internet. It provides a comprehensive directory of subscription lists to block advertisements, malware, trackers, and other general annoyances. First, install one of the tools mentioned below under "Software Support." Then, you can subscribe to a set of these lists inside of that software. If you need help or have a comment/question, open an [Issue](https://github.com/collinbarrett/FilterLists/issues). + +Using a software firewall or adblocker has become a key tool in protecting one's privacy online. While the current business model of the "free" internet relies upon advertising revenue, publishers have become too flippant about tracking users without their consent. Advertising networks track users' browsing habits around the internet building lucrative profiles to exploit for targeted marketing or big data research. Until internet publishers develop more transparency or a new business model, we must continue to take the protection of our privacy into our hands. + +Typical adblockers run as an extension in popular web browsers. As we browse the internet, they compare HTTP requests to their list of hosts and filters to selectively block advertisements, trackers, and malware. This filtering helps to protect the surfer's privacy, prevents [malvertising attacks](http://www.wired.com/insights/2014/11/malvertising-is-cybercriminals-latest-sweet-spot/ "Why Malvertising Is Cybercriminals' Latest Sweet Spot - Wired"), and [reduces bandwidth requirements](http://venturebeat.com/2015/07/08/blocking-ads-can-cut-network-traffic-25-to-40-study-shows/ "Blocking Ads Can Cut Network Traffic 25% to 40%, Study Shows - VentureBeat"). Thousands of contributors work hard to maintain these FilterLists for anyone to use. Locating and selecting these lists, however, has not historically been very easy. This project aims to solve that problem. + +## Software Support + +One can use of the lists on FilterLists in the following software tools. + +* [1Blocker](https://1blocker.com/) +* [AdAway](https://adaway.org/) +* [AdBlock](https://getadblock.com/) +* [Adblock Plus](https://adblockplus.org/) +* [AdGuard](https://adguard.com/) +* [uBlock Origin](https://github.com/gorhill/uBlock) +* ...[Did we forget one?](https://github.com/collinbarrett/FilterLists/issues) + +## Miscellany + +### Disclaimer + +FilterLists does not condone or endorse implementing any particular FilterList or blocking any particular advertisement network. Make sure to financially support your favorite sites in some way if you choose to block their advertisements. FilterLists is also in no way officially affiliated with any of the software vendors or list maintainers referenced on this site. + +### Terms + +FilterLists is open-source and provided as-is under the [MIT License](https://github.com/collinbarrett/FilterLists/blob/master/LICENSE). + +### Privacy + +We respect your privacy. That is the whole point of this site. The only minor data we collect about visitors is what [CloudFlare](https://www.cloudflare.com/analytics/) captures. \ No newline at end of file diff --git a/About.md b/About.md deleted file mode 100644 index d76382a9a..000000000 --- a/About.md +++ /dev/null @@ -1,40 +0,0 @@ -FilterLists helps to protect your privacy and security when using the Internet. It provides a comprehensive directory of subscription lists to block advertisements, malware, trackers, and other general annoyances. First, install one of the tools mentioned below under "Software Support." Then, you can subscribe to a set of these lists inside of that software. If you need help or have a comment/question, open an [Issue](https://github.com/collinbarrett/FilterLists/issues). - -## Background - -Using a software firewall (adblocker) has become a key tool in protecting one's privacy online. While the current business model of the "free" Internet relies upon advertising revenue, publishers have become too flippant about tracking users without their consent. Advertising networks track users' browsing habits around the Internet building lucrative profiles to exploit for targeted marketing or big data research. Until Internet publishers develop more transparency or a new business model, we must continue to take the protection of our privacy into our hands. - -Typical adblockers run as an extension in popular web browsers. As we browse the Internet, they compare HTTP requests to their list of hosts and filters to selectively block advertisements, trackers, and general annoyances. This filtering helps to protect the surfer's privacy, prevents [malvertising attacks](http://www.wired.com/insights/2014/11/malvertising-is-cybercriminals-latest-sweet-spot/ "Why Malvertising Is Cybercriminals' Latest Sweet Spot - Wired"), and [reduces bandwidth requirements](http://venturebeat.com/2015/07/08/blocking-ads-can-cut-network-traffic-25-to-40-study-shows/ "Blocking Ads Can Cut Network Traffic 25% to 40%, Study Shows - VentureBeat"). Many contributors work hard to maintain these filter lists for anyone to use. Locating and selecting these lists, however, has not historically been very easy. **FilterLists is the independent, comprehensive directory of filter and host lists for advertisements, trackers, malware, and annoyances.** - -## Software Support - -One can use [some](https://github.com/collinbarrett/FilterLists/issues/11) of the lists on FilterLists in the following software tools. - -* [1Blocker](https://1blocker.com/) -* [AdAway](https://adaway.org/) -* [AdBlock](https://getadblock.com/) -* [Adblock Plus](https://adblockplus.org/) -* [uBlock Origin](https://github.com/gorhill/uBlock) -* ...[Did we forget one?](https://github.com/collinbarrett/FilterLists/issues) - -## FilScorebeta - -FilScore continues to evolve into a general score for lists based on factors such as popularity, quality, update frequency, update recency, support, and coverage. It is not meant to be a final quality score for each list, but rather to provide visitors with an approximation as to which lists are of higher subjective quality than others. It primarily serves as a more meaningful way to sort the lists than merely alphabetical. Visit this [GitHub Project](https://github.com/collinbarrett/FilterLists/projects/1) to learn more and contribute to this feature. - -## Add List / Report Bug - -We collect list updates and bug reports on [GitHub](https://github.com/collinbarrett/FilterLists/issues). - -## Miscellany - -### Disclaimer - -FilterLists does not condone or endorse implementing any particular filter list or blocking any particular advertisement network. Make sure to financially support your favorite sites in some way if you choose to block their advertisements. FilterLists is also in no way officially affiliated with any of the software vendors or list maintainers referenced on this site. - -### Terms - -FilterLists is open-source ([mostly](https://github.com/collinbarrett/FilterLists#building)) and provided as-is under the [GPL-3.0](https://github.com/collinbarrett/FilterLists/blob/master/LICENSE) licence. - -### Privacy - -We respect your privacy. That is the whole point of this site. However, this site does collect some minor analytical data via both [CloudFlare](https://www.cloudflare.com/analytics/) and a self-hosted instance of [Piwik](https://piwik.org/) (IPs and fingerprints heavily anonymized). This data is used solely for developing improvements to this site (such as [FilScore](#filscorebeta)), and we never share individualized data.