docs: Convert to markdown (#311)

Author: tony

.github/workflows/publish-docs.yml

@@ -17,6 +17,26 @@ jobs:
         run: |
           git config --global user.name 'travis-ci'	
           git config --global user.email 'travis@nowhere.edu'
+
+      - name: Filter changed file paths to outputs
+        uses: dorny/paths-filter@v2.7.0
+        id: changes
+        with:
+          filters: |
+            root_docs:
+              - CHANGES
+              - README.*
+            docs:
+              - 'docs/**/*.rst'
+              - 'docs/**/*.md'
+              - 'examples/**'
+            python_files:
+              - 'vcspull/**'
+
+      - name: Should publish
+        if: steps.changes.outputs.docs == 'true' || steps.changes.outputs.root_docs == 'true' || steps.changes.outputs.python_files == 'true'
+        run: echo "PUBLISH=$(echo true)" >> $GITHUB_ENV
+
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v1
         with: