Your central privacy and security resource to protect yourself online.
About
Privacy Guides is a socially motivated website that provides information for protecting your data security and privacy. Our mission is to inform the public about the value of digital privacy, and global government initiatives which aim to monitor your online activity. We are a non-profit collective operated entirely by volunteer team members and contributors. Our website is free of advertisements and not affiliated with any of the listed providers.
The current list of team members can be found here. Additionally, many people have made contributions to the project, and you can too!
Featured on: Tweakers, The New York Times, Wired, and Fast Company.
Contributing
- 💬 Start a discussion or suggest an idea
- 💖 Sponsor the project
- 🈴 Help translate the site [Matrix chat]
- 📝 Edit the site, everything's accessible in this repo
- Browse our open issues to see what needs to be updated
- View the list of approved topics waiting for a PR
- Read some writing tips in our style guide
All contributors to the site are listed here. If you have contributed to the website or project, please add yourself to the list or ask @jonaharagon to make the change.
Mirrors
- GitHub Pages: privacyguides.github.io/privacyguides.org
- Netlify (AWS): illustrious-bavarois-56cf30.netlify.app
- BunnyCDN: privacyguides-org-production.b-cdn.net
- Hetzner: direct.privacyguides.org (discouraged!)
Alternative Networks
Note
Most hidden service providers are not very extensively used or tested, which is why we strongly recommend Tor. Using other networks could be more likely to endanger your anonymity, so make sure you know what you're doing.
Git Mirrors
License
This repository is REUSE compliant, meaning each file is individually annotated with copyright information. Typically, most content you would read on the site is CC BY-SA 4.0. You must always check the copyright license information in each file you copy before using it in your own work. If you are confused about who owns the copyright for a particular file or what license it is available under, please email jonah@privacyguides.org.
You may comply with our license terms in any reasonable manner, but not in any way that suggests Privacy Guides endorses you or your use. You may not use the Privacy Guides branding in your own project without express approval from this project. Privacy Guides's brand trademarks include the "Privacy Guides" wordmark and shield logo.
Developing
The only supported method of building and previewing this website locally is by running the automatic dev container. The easiest way to do this in your web browser without installing any software is to use GitHub Codespaces. To build the website locally, you will need the following software:
- macOS/Windows: Docker Desktop
- Linux: Docker CE
- VS Code
- Dev Containers for VS Code extension
- GitHub Desktop (optional)
You can technically use any IDE which supports development containers, but YMMV. Docker Desktop has an experimental Dev Environments option which allows you to use any text editor under Settings > Features in development. We are only testing with the combination of software above.
Committing to this repository requires signing your commits (git config commit.gpgsign true) unless you are making edits via the GitHub.com text editor interface. As of August 2022 the preferred signing method is SSH commit signatures, but GPG signing is also acceptable. You should add your signing key to your GitHub profile.
Releasing
It is required to create a GitHub release to publish the current site to privacyguides.org. The current main branch can be previewed at https://main.staging.privacyguides.dev prior to release.
- Create a new tag:
git tag -s YYYY.MM.DD -m 'Some message'- Tag numbering:
YYYY.MM.DD- if two+ releases are published on the same day, append short commit sha to next release, e.g.YYYY.MM.DD-6aa14e8 - Enable GPG tag signing by default (
git config tag.gpgSign true) to avoid missing signatures
- Tag numbering:
- Push the tag to GitHub:
git push --tags - A GitHub Release will be automatically created and deployed to the live site.
- You may wish to manually check or edit the release changelog/title after it is published for accuracy.
Contributors
Privacy Guides wouldn't be possible without these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome, including contributions to Privacy Guides outside of this repo, and contributions that aren't content related (like sharing ideas for Privacy Guides, promoting the project, answering questions on the forum, etc.).
CLI to generate this table:
all-contributors-cli generate
CLI to add a contributor:
all-contributors-cli add <username> <contribution>
See this table for valid contribution reasons, comma-separated. Do not use the content code for contributors to the website, use doc instead (this way it will automatically link to their commits). Example:
all-contributors-cli add jonaharagon doc,research,question