chore(ci): align docs workflow

.github/ISSUE_TEMPLATE/release.yaml

@@ -64,7 +64,7 @@ body:
   attributes:
     label: "**For major/minor releases only** Update Release documents"
     options:
-      - label: Trigger [synchronize_docs](https://github.com/Kong/kubernetes-ingress-controller/blob/main/.github/workflows/synchronize_docs.yaml) workflow.
+      - label: Trigger [release_docs](https://github.com/Kong/kubernetes-ingress-controller/blob/main/.github/workflows/release_docs.yaml) workflow. Note that you will need to update the new version's navigation manifest (e.g. [for 2.7](https://github.com/Kong/docs.konghq.com/blob/main/app/_data/docs_nav_kic_2.7.x.yml) to use the new file after.
       - label: Ensure a draft PR is created in [docs.konghq.com](https://github.com/Kong/docs.konghq.com/pulls) repository.
       - label: Update articles in the new version as needed.
       - label: Update `references/version-compatibility.md` to include the new versions (make sure you capture any new Kubernetes/Istio versions that have been tested)

.github/workflows/synchronize_docs.yaml → .github/workflows/release_docs.yaml

@@ -1,12 +1,23 @@
-name: Synchronize documentation with docs.konghq.com
+name: Create release docs PR
 
 on:
-  workflow_dispatch: {}
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'The version to release (e.g. v1.2.3)'
+        required: true
 
 jobs:
-  synchronize_docs:
+  create_docs_pr:
     runs-on: ubuntu-latest
     steps:
+      - name: Parse semver string
+        id: semver_parser
+        uses: booxmedialtd/ws-action-parse-semver@e81ad80123156d7ddd4f6c8383e63f497f857deb
+        with:
+          input_string: ${{ github.event.inputs.tag }}
+          version_extractor_regex: 'v(.*)$'
+
       - name: Checkout KIC repository
         uses: actions/checkout@v3
         with:
@@ -22,7 +33,7 @@ jobs:
       - name: Generate docs
         run: |
           ./scripts/apidocs-gen/post-process-for-konghq.sh \
-          docs.konghq.com/src/kubernetes-ingress-controller/references/custom-resources.md
+          docs.konghq.com/app/_src/kubernetes-ingress-controller/references/custom-resources-${{ steps.semver_parser.outputs.major }}.${{ steps.semver_parser.outputs.minor }}.x.md
 
       - name: Detect changes
         id: detect-changes
@@ -42,7 +53,7 @@ jobs:
         if: steps.detect-changes.outputs.HAS_CHANGES
         with:
           token: ${{ secrets.K8S_TEAM_BOT_GH_PAT }}
-          title: Synchronize auto-generated KIC API reference
+          title: Update docs for KIC ${{ steps.semver_parser.outputs.fullversion }}
           commit-message: Synchronize auto-generated KIC API reference
           committer: Kong's Team k8s bot <team-k8s+github-bot@konghq.com>
           author: Kong's Team k8s bot <team-k8s+github-bot@konghq.com>
@@ -51,7 +62,8 @@ jobs:
           base: main
           branch: kic-docs-sync
           delete-branch: true
+          draft: true
           labels: |
             Kubernetes Team
             review:autodoc
-          body: It synchronizes [KIC's auto-generated API reference](https://github.com/Kong/kubernetes-ingress-controller/blob/main/docs/api-reference.md).
+          body: Prepares documentation for KIC ${{ steps.semver_parser.outputs.fullversion }} release.

scripts/apidocs-gen/post-process-for-konghq.sh

@@ -27,6 +27,6 @@ cat "${CRD_REF_DOC}" >> "${POST_PROCESSED_DOC}"
 echo "<!-- vale on -->" >> "${POST_PROCESSED_DOC}"
 
 # Replace all description placeholders with proper include directives
-sed -i '' -E \
-  's/<!-- (.*) description placeholder -->/{% include_cached md\/kubernetes-ingress-controller\/\1_description.md kong_version=page.kong_version %}/' \
+sed -i -r \
+  's/<!-- (.*) description placeholder -->/{% include_cached md\/kic\/crd-ref\/\1_description.md kong_version=page.kong_version %}/' \
   "${POST_PROCESSED_DOC}"