diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml new file mode 100644 index 000000000..2b31b49aa --- /dev/null +++ b/.github/workflows/docs.yml @@ -0,0 +1,56 @@ +name: Build and Deploy API Documentation + +on: + push: + branches: + - adam/371_docs_workflow + # tags: + # - '[0-9]+\.[0-9]+\.[0-9]' + # - '![0-9]+\.[0-9]+\.[0-9]-[a-z]*' + # - '![0-9]+\.[0-9]+\.[0-9]-[A-Z]*' + +jobs: + generate_docs: + runs-on: ubuntu-latest + + permissions: + contents: write + + steps: + - uses: actions/checkout@v3 + with: + fetch-depth: 0 + - name: Set up JDK + uses: actions/setup-java@v3 + with: + distribution: 'temurin' + java-version: '17' + - name: Copy docs to docs/dokka directory + run: | + # git fetch origin docs:docs + git fetch origin adam/only_docs:adam/only_docs + # git checkout docs + git checkout adam/only_docs + mkdir -p docs/dokka || true + cp -R current/ docs/dokka/current + cp -R history/ docs/dokka/history + # git checkout ${{ github.ref_name }} + git checkout adam/371_docs_workflow + - name: Generate Dokka Documentation + run: ./gradlew dokkaHtmlMultiModule + - name: Update Docs Branch + run: | + TAG=$(git describe --tags --abbrev=0) + # git checkout docs + git checkout adam/only_docs + cp -R docs/dokka/history . + cp -R docs/dokka/current . + git add history + git add current + git fetch --tags + git config user.name github-actions + git config user.email github-actions@github.com + # git commit -m "Update API documentation for ${{ github.ref_name }}" + git commit -m "Update API documentation for $TAG" + # git push origin docs + git push origin adam/only_docs