From 41f6b02a7d6bd83a6636d83c0bcbaea6988cd6bb Mon Sep 17 00:00:00 2001 From: Hassan Abouelela Date: Sun, 29 May 2022 23:25:33 +0400 Subject: Update Docs CI For Multiversion Signed-off-by: Hassan Abouelela --- .github/workflows/docs.yaml | 39 ++++++++++++++++++++++++++++++++++----- 1 file changed, 34 insertions(+), 5 deletions(-) (limited to '.github/workflows') diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml index 79a96ea5..82344abc 100644 --- a/.github/workflows/docs.yaml +++ b/.github/workflows/docs.yaml @@ -13,8 +13,9 @@ concurrency: jobs: - build-deploy: - name: Build & Deploy Docs + latest-build: + # We only need to verify that the docs build with no warnings here + name: Build Latest Docs Version runs-on: ubuntu-latest steps: @@ -31,12 +32,40 @@ jobs: # https://github.com/bitprophet/releases/pull/82 - run: pip install six - - name: Generate AutoDoc References - run: sphinx-apidoc -o docs/output botcore -feM - - name: Generate HTML Site run: sphinx-build -nW -j auto -b html docs docs/build + - name: Upload Build Artifact + uses: actions/upload-artifact@v2 + with: + name: docs-latest + path: docs/build/* + + build-deploy: + name: Build & Deploy Docs + runs-on: ubuntu-latest + needs: + - latest-build + + steps: + - uses: actions/checkout@v2 + + - name: Install Python Dependencies + uses: HassanAbouelela/actions/setup-python@setup-python_v1.1.0 + with: + dev: true + python_version: 3.9 + install_args: "--extras async-rediscache" + + # Undeclared dependency for `releases`... whoops + # https://github.com/bitprophet/releases/pull/82 + - run: pip install six + + - name: Build All Doc Versions + run: sphinx-multiversion docs docs/build -n -j auto + env: + BUILD_DOCS_FOR_HEAD: True + - name: Upload Build Artifact uses: actions/upload-artifact@v2 with: -- cgit v1.2.3