ci: update versoning pipeline and add comments for clarity

Author: Jwilson2000

.github/workflows/versioning.yml

@@ -1,4 +1,4 @@
-name: Version Control
+name: Versioning
 on:
   push:
     tags: [ 'v*.*.*' ]
@@ -8,32 +8,44 @@ jobs:
     name: versioning
     runs-on: ubuntu-latest
     steps:
-      - name: Copy files to temporary directory
-        shell: bash
-        run: |
-          cp -r content/latest tmp/content/latest
+      # Checkout tag being pushed
+      - name: Checkout tag
+        uses: actions/checkout@v4
 
       # This would be better if we had a current version JSON or something somewhere
       - name: Get prior version
+        id: get_tag
         run: |
           PRIOR_VERSION=$(git tag -l --sort=-v:refname | head -n 1 | sed "s/v//g" | sed "s/\./-/g")
           echo "PRIOR_VERSION=$PRIOR_VERSION" >> $GITHUB_ENV
           echo "Prior version tag: $PRIOR_VERSION"
 
+      # Checkout main
       - name: Checkout main branch
         uses: actions/checkout@v4
         with:
-          ref: main
+          ref: ${{ steps.get_tag.outputs.PRIOR_VERSION }}
+          path: old
           fetch-depth: 0
 
+      # Moves the old latest into it's corresponding version folder
       - name: Add current latest to prior version
         shell: bash
         run: |
+          cd main
           mkdir "content/versions/$PRIOR_VERSION"
           cp -r content/latest "content/versions/$PRIOR_VERSION"
       
+      # Replaces latest with the new tag latest content
       - name: Replace latest with tagged latest
         shell: bash
         run: |
           rm -r content/latest/*
-          cp -r tmp/content/latest content/latest
+          cp -r ../content/latest content/latest
+
+      # Commits changes to main
+      - name: Commit and replace
+        run: |
+          git add .
+          git commit -m "Migrated ${{ github.ref_name }} into latest"
+          git push origin main