mirror of
https://github.com/privacyguides/privacyguides.org
synced 2024-11-10 13:13:35 +01:00
.github | ||
.well-known | ||
docs | ||
mkdocs-material@f02ab2a15e | ||
theme | ||
.gitattributes | ||
.gitignore | ||
.gitmodules | ||
.markdownlint.yml | ||
CHANGELOG.md | ||
LICENSE | ||
mkdocs.production.yml | ||
mkdocs.yml | ||
Pipfile | ||
Pipfile.lock | ||
README.md |
About
Privacy Guides is a socially motivated website that provides information for protecting your data security and privacy. We are a non-profit collective operated entirely by volunteer team members and contributors.
Our current list of team members can be found here. Additionally, many people have made contributions to the project, and you can too!
Contributing
- 💬 Start a discussion or suggest an idea
- 💖 Sponsor the project
- 📝 Edit the site, everything's accessible in this repo
- Browse our open issues to see what needs to be updated
- When making more significant (than simple typo fixes, etc.) changes, update the changelog
- View some contribution tips on our contributor's wiki
Developing
- Clone this repository:
git clone https://github.com/privacyguides/privacyguides.org
- Install Python 3.6+
- Install mkdocs-material:
pip install mkdocs-material
- Serve the site locally:
mkdocs serve
- The site will be available at
http://localhost:8000/
- The site will be available at
Your local site will appear slightly different, because the production version of the website uses a private/custom build of mkdocs-material with additional features.
Team members with access to mkdocs-material-insiders should instead:
- Clone this repository and submodules:
git clone --recurse-submodules https://github.com/privacyguides/privacyguides.org
- Install Python 3.6+
- Install pipenv:
pip install pipenv
- Start a pipenv shell:
pipenv shell
- Install dependencies:
pipenv install --dev
- Serve the site locally:
mkdocs serve --config-file mkdocs.production.yml
- The site will be available at
http://localhost:8000
- You can build the site locally with
mkdocs build --config-file mkdocs.production.yml
- This version of the site should be identical to the live, production version
- The site will be available at
Releasing
- Create a new tag:
git tag -s v2.X.X -m 'Some message'
- View existing tags
- Tag numbering: Increment the MINOR (2nd) number when making significant changes (adding/deleting pages, etc.), increment the PATCH (3rd) number when making minor changes (typos, bug fixes). Probably leave the MAJOR number at 2 until a massive redesign (v1 -> v2 was the Jekyll to MkDocs transition).
- Push the tag to GitHub:
git push --tags
- Create a new release selecting the new tag
- Title the release the same as the tag version number without the
v
, i.e.2.X.X
- GitHub should let you auto-generate release notes, otherwise copy notes from the changelog
- Title the release the same as the tag version number without the
- Publish release, it will be deployed to the live site automatically