diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml new file mode 100644 index 00000000..af8eaf1f --- /dev/null +++ b/.github/workflows/documentation.yml @@ -0,0 +1,30 @@ +name: Build Documentation +on: + push: + branches: + - main + tags: + - "*" + pull_request: + branches: + - "*" + +permissions: + contents: write + +jobs: + build-documentation: + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v3 + + - name: Build Docs + run: | + ./script/build_docs + + - name: Deploy Docs + if: github.ref == 'refs/heads/main' + uses: JamesIves/github-pages-deploy-action@v4 + with: + folder: docs diff --git a/script/build_docs.zsh b/script/build_docs similarity index 74% rename from script/build_docs.zsh rename to script/build_docs index cac9eddf..88aa81a6 100755 --- a/script/build_docs.zsh +++ b/script/build_docs @@ -1,15 +1,12 @@ -#!/bin/zsh - -GIT_ROOT=$(git rev-parse --show-toplevel) -pushd "${GIT_ROOT}" 2>&1 >/dev/null +#!/usr/bin/env sh export DOCC_JSON_PRETTYPRINT="YES" +mkdir -p docs + swift package --allow-writing-to-directory docs \ generate-documentation --target Nimble \ --disable-indexing \ --transform-for-static-hosting \ --hosting-base-path 'https://quick.github.io/Nimble' \ --output-path docs - -popd diff --git a/script/release b/script/release index 742dbcfd..ba0d0339 100755 --- a/script/release +++ b/script/release @@ -127,11 +127,7 @@ else git add ${PODSPEC} || { restore_podspec; die "Failed to add ${PODSPEC} to INDEX"; } - echo "--- Updating Docs ---" - ./script/build_docs.zsh - git add docs || { git co docs; die "Failed to add docs to INDEX"; } - - git commit -m "[$VERSION_TAG] Update docs and podspec" || { restore_podspec; die "Failed to push updated version: $VERSION"; } + git commit -m "[$VERSION_TAG] Update podspec" || { restore_podspec; die "Failed to push updated version: $VERSION"; } fi RELEASE_NOTES="Version ${VERSION}. Open https://github.com/Quick/Nimble/releases/tag/$VERSION_TAG for full release notes."