Publish documentation to docs.junit.org GitHub repo's main branch

Author: marcphilipp

.github/workflows/main.yml

@@ -103,8 +103,6 @@ jobs:
       cancel-in-progress: true
     needs: macOS
     runs-on: ubuntu-latest
-    permissions:
-      contents: write
     steps:
     - name: Check out repository
       uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
@@ -136,4 +134,4 @@ jobs:
           -Dscan.tag.Documentation
       env:
         GIT_USERNAME: git
-        GIT_PASSWORD: ${{ secrets.GITHUB_TOKEN }}
+        GIT_PASSWORD: ${{ secrets.JUNIT_BUILDS_GITHUB_TOKEN_DOCS_REPO }}

.github/workflows/release.yml

@@ -180,8 +180,6 @@ jobs:
     name: Publish documentation
     needs: publish_deployment
     runs-on: ubuntu-latest
-    permissions:
-      contents: write
     steps:
       - name: Check out repository
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
@@ -211,7 +209,7 @@ jobs:
         uses: ./.github/actions/run-gradle
         env:
           GIT_USERNAME: git
-          GIT_PASSWORD: ${{ secrets.GITHUB_TOKEN }}
+          GIT_PASSWORD: ${{ secrets.JUNIT_BUILDS_GITHUB_TOKEN_DOCS_REPO }}
         with:
           encryptionKey: ${{ secrets.GRADLE_ENCRYPTION_KEY }}
           arguments: |

documentation/documentation.gradle.kts

@@ -109,10 +109,9 @@ val ota4jDocVersion = libs.versions.opentest4j.map { if (it.isSnapshot()) "snaps
 val apiGuardianDocVersion = libs.versions.apiguardian.map { if (it.isSnapshot()) "snapshot" else it }.get()
 
 gitPublish {
-	repoUri = "https://github.com/junit-team/junit5.git"
-	referenceRepoUri = rootDir.toURI().toString()
+	repoUri = "https://github.com/junit-team/docs.junit.org.git"
 
-	branch = "gh-pages"
+	branch = "main"
 	sign = false
 	fetchDepth = 1
 
@@ -121,14 +120,14 @@ gitPublish {
 
 	contents {
 		from(docsDir)
-		into("docs")
+		into(".")
 	}
 
 	preserve {
 		include("**/*")
-		exclude("docs/$docsVersion/**")
+		exclude("$docsVersion/**")
 		if (replaceCurrentDocs) {
-			exclude("docs/current/**")
+			exclude("current/**")
 		}
 	}
 }