docs(operator): refine advanced configuration and deployment docs, restructure GitHub Pages workflow (#1182)

Author: kimpenhaus

.github/workflows/gh-pages.yml

@@ -22,9 +22,6 @@ concurrency:
 jobs:
   build:
     runs-on: ubuntu-latest
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
     steps:
       - uses: actions/checkout@v7
 
@@ -51,6 +48,13 @@ jobs:
         with:
           path: docs/build
 
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v5

docs/docs/operator/advanced-configuration.mdx

@@ -6,7 +6,7 @@ sidebar_position: 8
 
 # Advanced Configuration
 
-This guide covers advanced configuration options for KubeOps operators, including finalizer management, custom leader election, and durable requeue mechanisms.
+This guide covers advanced configuration options for KubeOps operators, including finalizer management, custom leader election, and triggering reconciliation from external sources.
 
 ## Configuring the Operator
 

docs/docs/operator/deployment.mdx

@@ -182,7 +182,6 @@ kubectl apply -f https://github.com/your-org/your-operator/releases/download/v1.
    - Run multiple replicas for redundancy
    - Configure leader election for coordinated operation (see [Advanced Configuration - Leader Election](./advanced-configuration#custom-leader-election))
    - Consider namespace-based distribution for horizontal scaling
-   - Implement durable requeue mechanisms for reliability (see [Advanced Configuration - Custom Requeue Mechanism](./advanced-configuration#custom-requeue-mechanism))
 
 5. **Updates**:
    - Document upgrade procedures