diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 567d1e5c4b..2ea9b9126a 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -18,14 +18,16 @@ /docs/ @edenlightning @lantiga @borda @awaelchli @RobertLaurella /.github/*.md @edenlightning @williamfalcon @lantiga @borda /.github/ISSUE_TEMPLATE/ @edenlightning @borda @tchaton @awaelchli +/docs/source-fabric/conf.py @borda @awaelchli @carmocca +/docs/source-fabric/index.rst @awaelchli @lantiga @carmocca /docs/source-pytorch/conf.py @borda @awaelchli @carmocca /docs/source-pytorch/index.rst @williamfalcon @lantiga /docs/source-pytorch/levels @williamfalcon @RobertLaurella /docs/source-pytorch/expertise_levels @williamfalcon @RobertLaurella -/docs/source/ @williamfalcon @RobertLaurella @tchaton @awaelchli -/docs/source/conf.py @borda @awaelchli @carmocca -/docs/source/index.rst @williamfalcon @lantiga -/docs/source/expertise_levels @williamfalcon @RobertLaurella +/docs/source-app/ @williamfalcon @RobertLaurella @tchaton @awaelchli +/docs/source-app/conf.py @borda @awaelchli @carmocca +/docs/source-app/index.rst @williamfalcon @lantiga +/docs/source-app/expertise_levels @williamfalcon @RobertLaurella # PyTorch Lightning /src/lightning/pytorch @williamfalcon @awaelchli @carmocca @justusschock diff --git a/.github/workflows/docs-build.yml b/.github/workflows/docs-build.yml index a3cd6106f0..bd2ad4da31 100644 --- a/.github/workflows/docs-build.yml +++ b/.github/workflows/docs-build.yml @@ -1,9 +1,10 @@ -name: Check Docs +name: Build Docs # https://github.com/marketplace/actions/sphinx-build on: push: branches: ["master", "release/*"] + tags: ["*"] # use this event type to share secrets with forks. # it's important that the PR head SHA is checked out to run the changes pull_request_target: @@ -166,9 +167,17 @@ jobs: # Uploading docs to GCS, so they can be served on lightning.ai - name: Upload docs/stable to GCS 🪣 if: startsWith(github.ref, 'refs/heads/release/') + # todo: consider nuke the bucket content before upload run: gsutil -m rsync -d -R docs/build/html/ gs://lightning-docs-${{ matrix.pkg-name }}/stable # Uploading docs to GCS, so they can be served on lightning.ai - name: Upload docs/latest to GCS 🪣 if: github.ref == 'refs/heads/master' + # todo: consider nuke the bucket content before upload run: gsutil -m rsync -d -R docs/build/html/ gs://lightning-docs-${{ matrix.pkg-name }}/latest + + # Uploading docs to GCS, so they can be served on lightning.ai + - name: Upload docs/latest to GCS 🪣 + if: startsWith(github.ref, 'refs/tags/') + # todo: consider nuke the bucket content before upload + run: gsutil -m rsync -d -R docs/build/html/ gs://lightning-docs-${{ matrix.pkg-name }}/${{ github.ref_name }}" diff --git a/Makefile b/Makefile index bd27d98264..6dec5981bd 100644 --- a/Makefile +++ b/Makefile @@ -16,12 +16,15 @@ clean: rm -rf .mypy_cache rm -rf .pytest_cache rm -rf ./docs/build + rm -rf ./docs/source-fabric/generated + rm -rf ./docs/source-fabric/*/generated + rm -rf ./docs/source-fabric/api rm -rf ./docs/source-pytorch/notebooks rm -rf ./docs/source-pytorch/generated rm -rf ./docs/source-pytorch/*/generated rm -rf ./docs/source-pytorch/api - rm -rf ./docs/source/generated - rm -rf ./docs/source/*/generated + rm -rf ./docs/source-app/generated + rm -rf ./docs/source-app/*/generated rm -rf build rm -rf dist rm -rf *.egg-info @@ -47,7 +50,7 @@ test: clean docs: clean pip install -e . --quiet -r requirements/app/docs.txt - cd docs/source && $(MAKE) html + cd docs/source-app && $(MAKE) html update: git submodule update --init --recursive --remote