chore: address comments

.github/workflows/pull_request_secure.yml

@@ -271,6 +271,12 @@ jobs:
           token: ${{ secrets.JRELEASER_GITHUB_TOKEN }} # Safe; only used to clone the repo and not stored in the fork.
           fetch-depth: 0 # Otherwise merge will fail on account of not having history.
 
+      - name: Checkout timefold-solver
+        uses: actions/checkout@v4
+        with:
+          path: ./timefold-solver
+          ref: ${{ github.event.pull_request.head.sha }} # The GHA event will pull the main branch by default, and we must specify the PR reference version
+
       - name: Set up NodeJs
         uses: actions/setup-node@v4
         with:
@@ -281,7 +287,11 @@ jobs:
         env:
           GIT_CREDENTIALS: ${{ secrets.GIT_CREDENTIALS }}
         run: |
-          sed -i 's/tags:\s*\[v[0-9.]*,\s*v0.8.42]/tags: \[main]/' apps/docs/antora-playbook.yml
+          ls ~
+          ls /
+          cp ${{ github.workspace }}/timefold-solver/docs/src/antora-playbook-template.yml apps/docs/antora-playbook.yml
+          sed -i 's/REPLACEME/${{ github.head_ref }}/' apps/docs/antora-playbook.yml
+          cat apps/docs/antora-playbook.yml
           npm ci
           npm run build -- --filter docs
 
@@ -293,7 +303,8 @@ jobs:
           apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
           accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
           workingDirectory: ./apps/docs
-          command: pages deploy ./public-serve --project-name=timefold-docs --branch=${{ github.ref }}
+#          command: pages deploy ./public-serve --project-name=timefold-docs --branch=${{ github.ref }}
+          command: echo "deploy"
 
   sonarcloud:
     needs: approval_required

docs/src/antora-playbook-template.yml

@@ -0,0 +1,31 @@
+site:
+  title: Timefold Documentation
+  url: https://docs.timefold.ai
+  start_page: /
+  robots: allow
+  keys:
+    google_tag_manager: GTM-TBSQGHJ2
+    cache_key: { timeFoldCacheKey } #This is a placeholder for the cache key, will be filled in at build time
+
+urls:
+  html_extension_style: drop
+
+content:
+  edit_url: '{web_url}/edit/main/{path}'
+  sources:
+    - url: [email protected]:timefoldai/timefold-solver.git
+      branches: [REPLACEME]
+      tags: ~
+      start_path: docs/src
+ui:
+  bundle:
+    url: build/ui-bundle.zip
+
+runtime:
+  fetch: true
+  log:
+    failure_level: error
+
+asciidoc:
+  extensions:
+    - '@asciidoctor/tabs'