Merge pull request #782 from Licini/doc-fix

stop deploy PRs and only keep latest patch

Author: tomvanmele

.github/workflows/cleanup.yml

@@ -14,6 +14,9 @@ jobs:
   build:
     name: build and deploy docs
     runs-on: ubuntu-latest
+    outputs:
+      commit_type: ${{ steps.docs.outputs.commit_type }}
+      current_patch: ${{ steps.docs.outputs.current_patch }}
     env:
       GH_PAT: ${{secrets.GH_PAT}}
     steps:
@@ -31,7 +34,8 @@ jobs:
         run: |
           python -m pip install --no-cache-dir -r requirements-dev.txt
       - name: Generate docs
-        if: ${{ success() }}
+        if: success()
+        id: docs
         run: |
           invoke docs
           # Get branch/tag/latest name from git
@@ -40,19 +44,23 @@ jobs:
               if [[ $BASH_REMATCH = pull* ]]; then
                   echo This is a pull request
                   FOLDER_NAME=pull_${BASH_REMATCH##*/}
+                  echo "::set-output name=commit_type::pull"
               elif [[ $BASH_REMATCH = tags/* ]]; then
                   echo This is a version tag
                   FOLDER_NAME=${BASH_REMATCH##*/v}
+                  echo "::set-output name=commit_type::tag"
+                  echo "::set-output name=current_patch::$FOLDER_NAME"
               else
                   echo This is a commit to main branch
                   FOLDER_NAME=latest
+                  echo "::set-output name=commit_type::main"
               fi;
           fi;
           echo "Docs will be deployed to https://compas.dev/compas/$FOLDER_NAME"
           mkdir -p deploy/$BRANCH_OR_TAG && mv -T dist/docs deploy/$FOLDER_NAME/
 
       - name: Deploy docs
-        if: success() && env.GH_PAT != ''
+        if: success() && env.GH_PAT != '' && steps.docs.outputs.commit_type != 'pull'
         uses: crazy-max/ghaction-github-pages@v2
         with:
           target_branch: gh-pages
@@ -63,27 +71,36 @@ jobs:
 
   docVersions:
     needs: build
+    if: needs.build.outputs.commit_type == 'tag'
     name: update doc versions
     runs-on: ubuntu-latest
     env:
       GH_PAT: ${{secrets.GH_PAT}}
+      CURRENT_PATCH: ${{needs.build.outputs.current_patch}}
     steps:
-
       - uses: actions/checkout@v2
         with:
           ref: gh-pages
 
       - name: update doc versions
         run: |
-          >doc_versions.txt
+          echo latest > doc_versions.txt
+          CURRENT_MINOR=${CURRENT_PATCH%.*}
+          echo current patch: $CURRENT_PATCH current minor: $CURRENT_MINOR
           for folder in $(ls -rd */ | tr -d '/')
           do
-              if [[ $folder =~ ^[0-9]{1,2}\.[0-9]{1,2}\.[0-9]{1,2}$|^latest$ ]]
-              then
-                  echo ${folder}  >> doc_versions.txt
+              if [[ $folder =~ ^[0-9]{1,2}\.[0-9]{1,2}\.[0-9]{1,2}$ ]]; then
+                  PATCH=$folder
+                  MINOR=${folder%.*}
+                  if [[ $PATCH != $CURRENT_PATCH && $MINOR = $CURRENT_MINOR ]]; then
+                      echo $PATCH will be deleted
+                      rm -Rf $PATCH
+                  else
+                      echo $PATCH  >> doc_versions.txt
+                  fi
               fi
           done
-          echo found available doc versions:
+          echo updated doc versions:
           cat doc_versions.txt
 
       - name: Deploy docs