Automate docs release

Author: tcbegley

.github/actions/push_docs/action.yml

@@ -0,0 +1,29 @@
+name: Push Docs
+description: Push Docs to Heroku
+inputs:
+  heroku-api-token:
+    description: API token for Heroku
+    required: true
+  heroku-app-name:
+    description: App name
+    required: true
+  commit_user_name:
+    description: Name used for the commit user
+    required: false
+    default: GitHub Actions
+  commit_user_email:
+    description: Email address used for the commit user
+    required: false
+    default: [email protected]
+runs:
+  using: "composite"
+  steps:
+    - run: |
+       git checkout -b inv-push-docs
+       git add docs/examples/vendor/*.py -f
+       git -c user.name="${{ inputs.commit_user_name }}" -c user.email="${{ inputs.commit_user_email }}" commit -m "Add examples" --allow-empty
+       git subtree split --prefix docs -b inv-push-docs-subtree
+       git push -f https://heroku:${{ inputs.heroku-api-token }}@git.heroku.com/${{ inputs.heroku-app-name }}.git inv-push-docs-subtree:master
+       git checkout master
+       git branch -D inv-push-docs inv-push-docs-subtree
+      shell: bash

.github/workflows/build-docs.yml

@@ -0,0 +1,28 @@
+name: Build docs
+
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - docs/**
+      - examples/**
+
+jobs:
+  build_docs:
+    name: Build and release documentation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Python 3.8
+        uses: actions/setup-python@v1
+        with:
+          python-version: 3.8
+      - name: Install Python dependencies
+        run: python -m pip install invoke semver termcolor
+      - name: Copy examples to docs/
+        run: invoke copy-examples
+      - uses: ./.github/actions/push_docs
+        with:
+          heroku-api-token: ${{ secrets.HEROKU_API_TOKEN }}
+          heroku-app-name: ${{ secrets.HEROKU_APP_NAME }}