Add docs workflow (#179)

.github/workflows/docs.yml

@@ -0,0 +1,38 @@
+name: Publish documentation
+
+on:
+  push:
+    branches:
+      - main
+      - gh-pages
+    tags:
+      - "**"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+          # Looks like it's not working very well for other people:
+          # https://github.com/actions/setup-python/issues/436
+          # cache: "pip"
+          # cache-dependency-path: pyproject.toml
+
+      - name: Install dependencies
+        if: steps.cache.outputs.cache-hit != 'true'
+        run: pip install -e .[docs]
+      - name: Set git credentials
+        run: |
+          git config --global user.name "${{ github.actor }}"
+          git config --global user.name "${{ github.actor }}@users.noreply.github.com"
+
+      - run: mike deploy dev --push
+        if: github.ref == 'refs/heads/main'
+
+      - run: mike deploy latest ${{ github.ref_name }} --push
+        if: startsWith(github.ref, 'refs/tags/')

mkdocs.yml

@@ -18,7 +18,7 @@ extra_css:
 theme:
   name: material
   logo: assets/logo.svg
-  favicon: assets/distilabel-icon.svg
+  favicon: assets/logo.svg
   features:
     - navigation.instant
     - navigation.tabs