Merge branch 'main' into patch-1

Author: westurner

.github/workflows/translation.yml

@@ -0,0 +1,47 @@
+name: Translation
+
+on:
+   workflow_run:
+     workflows:
+     - Test
+     branches:
+     - main
+     types:
+     - completed
+
+jobs:
+   build:
+     runs-on: ubuntu-latest
+
+     steps:
+       - name: Grab the repo src
+         uses: actions/checkout@v2
+
+       - name: Set up Python
+         uses: actions/setup-python@v2
+         with:
+           python-version: 3.9
+
+       - name: Install Python tooling
+         run: python -m pip install --upgrade nox virtualenv
+
+       - name: Generate a fresh POT file out of RST documents
+         run: python -m nox -s translation
+
+       - name: Commit the POT file to Git
+         run: |
+           git config --local user.email "github-actions[bot]@users.noreply.github.com"
+           git config --local user.name "github-actions[bot]"
+           git_hash=$(git rev-parse --short "${GITHUB_SHA}")
+           git commit -m "Update messages.pot as of version ${git_hash}" locales/messages.pot
+
+       - name: Check if any sources have changed since the last update
+         if: failure()
+         run: echo "There are no changes to the RST sources since the last update. Nothing to do."
+
+       - name: >-
+           Push the updated POT file back to
+           ${{ github.repository }}@${{ github.event.repository.default_branch }}
+           on GitHub
+         run: |
+           git push --atomic origin HEAD:${{ github.event.repository.default_branch }}

.gitignore

@@ -3,3 +3,4 @@ build/
 .nox
 *.pyc
 __pycache__
+.DS_Store

.readthedocs.yaml

@@ -0,0 +1,15 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+version: 2
+
+sphinx:
+   configuration: source/conf.py
+   # The config file overrides the UI settings:
+   # https://github.com/pyca/cryptography/issues/5863#issuecomment-792343136
+   builder: dirhtml
+
+python:
+   version: 3.8
+   install:
+   - requirements: requirements.txt