feat: revert to Hybrid SEO-First architecture (V1 at Root, V2 at /v2/) [skip ci]

2026-05-27 19:45:42 +00:00 · 2026-05-26 01:22:34 +02:00
parent 954beb9cbc
commit 515fa782cc
7 changed files with 48 additions and 25 deletions
--- a/.github/workflows/06.1.main.yml
+++ b/.github/workflows/06.1.main.yml
@@ -35,13 +35,34 @@ jobs:
        run: |
          pip install -r requirements.txt

-      # 1. Build V2 (Root)
-      - name: Build V2 Elite Edition
-        run: mkdocs build -f v2-mkdocs.yml -d site/
-
-      # 2. Build V1 (Subdirectory)
+      # 1. Build V1 (Root) - Preserves all legacy links for SEO
      - name: Build V1 Edition
-        run: mkdocs build -f mkdocs.yml -d site/v1/
+        run: mkdocs build -f mkdocs.yml -d site/
+
+      # 2. Build V2 Elite Edition (/v2/)
+      - name: Build V2 Elite Edition
+        run: mkdocs build -f v2-mkdocs.yml -d site/v2/
+
+      # 3. Duplicate V1 to /v1/ - Provides an explicit path to the exhaustive archive
+      - name: Duplicate V1 to /v1/
+        run: cp -r site/ site/v1/
+
+      # 4. Inject Root Redirect to V2 - Human visitors land on V2 by default
+      - name: Inject Root Redirect to V2
+        run: |
+          cat << 'EOF' > site/index.html
+          <!DOCTYPE html>
+          <html>
+            <head>
+              <meta charset="utf-8">
+              <title>Nubenetes Redirect</title>
+              <meta http-equiv="refresh" content="0; url=/v2/">
+            </head>
+            <body>
+              <p>Redirecting to the V2 Elite Portal. <a href="/v2/">Click here</a>.</p>
+            </body>
+          </html>
+          EOF

      - name: Setup Pages
        uses: actions/configure-pages@v4
--- a/GEMINI.md
+++ b/GEMINI.md
@@ -363,12 +363,12 @@ The bot must rotate between profiles to avoid detection:
        - **Workflow Hardening (Race Condition Fix)**: Implemented a mandatory `git pull --rebase` strategy across all automated bots to prevent concurrent push failures.
        - **Ultra-Visible Branding**: Standardized on a minimalist Cyan "N" favicon (`favicon-ultra.png`) and restored the original hero car imagery to the V2 index.
        - **O'Reilly Journey Builder**: Refined the O'Reilly-style technical hierarchy in the V2 portal to ensure a logical knowledge progression from foundations to advanced internals.
-        - **Platinum SEO Mitigation**: Implemented a "Smart 404" rescue system and root-to-subdirectory migration logic for the V2/V1 transition.
-        *   **May 2026**: **Site-Wide Architecture Promotion**:
-        - **V2 at Root**: Promoted the Elite Portal to the domain root (`/`) and moved the archive to `/v1/`.
-        - **Direct-Push Automation**: Refactored workflows to push directly to `develop` using `[skip ci]`, removing PR noise for derived content.
-        - **Artifact-Based Auditing**: Shifted architecture reports to GitHub Artifacts for cleaner project history.
-
+        - **Platinum SEO Mitigation**: Implemented a "Smart 404" rescue system and a **Hybrid SEO-First Architecture** that preserves V1 at the root while redirecting human traffic to the V2 Elite Portal.
+        *   **May 2026**: **Hybrid SEO-First Architecture Reversion**:
+        - **V1 Restoration (Root)**: Restored the V1 Archive to the root (`/`) to protect historical deep-links and SEO authority.
+        - **V2 Relocation (/v2/)**: Moved the Elite Portal to a dedicated subdirectory.
+        - **Smart Root Redirect**: Implemented an automatic meta-refresh in the root `index.html` to guide human visitors to the V2 experience without breaking search engine indices.
+        - **V1 Fallback (/v1/)**: Duplicated the archive to `/v1/` for explicit navigation.
 - **V2 Index Metrics Protocol**: The "Knowledge Architecture and AI Coverage Status" report in the V2 index MUST include a direct comparison between V1 and V2 inventory. This report MUST display: 1. **V1 Base Inventory** (Total resources in the master archive), 2. **V2 Elite Selection** (Count of candidates and the resulting density ratio), 3. **AI Enrichment Coverage**, and 4. **GitHub Metadata Coverage**. This ensures transparency in the knowledge distillation process.
 - **Redundancy-Free Branding**: To ensure professional UI density, the V2 Portal header MUST NOT repeat the "Nubenetes" brand. The title MUST follow the pattern: "Nubenetes Elite Portal (V2) | Awesome Kubernetes and Cloud".
 - **Decoupled Workflow Architecture**: The Agentic V2 ecosystem MUST utilize a decoupled micro-workflow structure (Health Monitor, Metadata Engine, AI Curator, and Publisher) to optimize compute quotas and minimize Gemini token consumption. Any update to the V2 rendering logic MUST use the `--render-only` flag in the Publisher pipeline to maintain execution speed.
--- a/README.md
+++ b/README.md
@@ -340,13 +340,14 @@ Nubenetes operates with two distinct editions to serve different engineering nee

 ### 5.1. V1: The Exhaustive Archive
 - **Purpose:** Preservation of all technical knowledge since 2018.
- **Scope:** 17,000+ links across 160+ pages.
+- **SEO Guard:** Deployed at the domain root (`/`) to preserve 6+ years of historical backlinks and deep-links.
+- **Fallback Access:** Also available at [nubenetes.com/v1/](https://nubenetes.com/v1/).
 - **Source of Truth:** The `docs/` directory.
- **Deployment:** [nubenetes.com/v1/](https://nubenetes.com/v1/)

 ### 5.2. V2: The Agentic Elite Edition
 - **Purpose:** A high-density, enterprise-grade portal for the modern Cloud Native ecosystem (2026 and beyond).
- **Default Experience:** Deployed as the primary landing page at the domain root.
+- **Default Experience:** Deployed at `/v2/`.
+- **Root Redirection:** The root `index.html` automatically redirects human visitors to this portal.
 - **Algorithm:** Uses the **Incremental Elite Engine** to select and classify top-tier resources.
 - **Aesthetic:** "Cyber Cloud" styling (pure black backgrounds, neon cyan accents, advanced glassmorphism).
 - **Visual Standards (Elite Hierarchy):**
@@ -359,7 +360,7 @@ Nubenetes operates with two distinct editions to serve different engineering nee
 - **Semantic Cross-Linking:** The portal autonomously identifies and links related categories within the same strategic dimension (e.g., suggesting `Flux` when reading about `Argo`), creating a cohesive **Industrial Knowledge Graph**.
 - **Executive Context**: Every strategic dimension features an AI-generated **State-of-the-Art Introduction** providing high-level architectural context and industry direction before the link listings.
 - **Source of Truth:** The `v2-docs/` directory (Derived from V1).
- **Deployment:** [nubenetes.com/](https://nubenetes.com/)
+- **Deployment:** [nubenetes.com/v2/](https://nubenetes.com/v2/)

 ### 5.3. Architecture Comparison Matrix: V1 vs. V2
 To better understand the dual-nature of the project, the following matrix details the technical and philosophical differences between the two editions:
@@ -906,7 +907,8 @@ graph LR
    D --> E["V2 Update (develop)"]
    M["Sync to 'master'"] --> C["Pip Cache & CI/CD Build"]
    C --> F["Upload Pages Artifact"]
-    F --> G["Native Deploy to nubenetes.com (V2) and /v1/ (Archive)"]
+    F --> G["Native Deploy: V1 (Root/SEO), V2 (/v2/), V1 Fallback (/v1/)"]
+    G --> H["Inject Root Redirect to /v2/"]
    Z --> B
    Z --> B
 ```
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,7 +1,7 @@
 # Nubenetes: Awesome Kubernetes & Cloud [![Awesome](https://cdn.jsdelivr.net/gh/sindresorhus/awesome@d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome)

 !!! tip "Nubenetes V2: Agentic Elite Edition is now live!"
-    Looking for a high-density, AI-curated experience? Explore our [**V2 Elite Portal**](/) - Optimized for 2026 Architectural Standards.
+    Looking for a high-density, AI-curated experience? Explore our [**V2 Elite Portal**](/v2/) - Optimized for 2026 Architectural Standards.

 A curated list of awesome references collected since 2018. Microservices architectures rely on DevOps practices, automation, CI/CD (Continuous Integration & Delivery), and API-focused designs.

--- a/mkdocs-v1-archive.yml
+++ b/mkdocs-v1-archive.yml
@@ -1,5 +1,5 @@
 site_name: Nubenetes
-site_url: https://nubenetes.com/v1/
+site_url: https://nubenetes.com/
 site_description: A curated list of awesome IT projects and resources. Inspired by the awesome list.
 site_author: nubenetes@gmail.com
 docs_dir: docs/
@@ -85,7 +85,7 @@ markdown_extensions:
  - abbr
  - def_list
 nav:
-  - "🚀 Try Nubenetes V2 (Elite Portal)": https://nubenetes.com/
+  - "🚀 Try Nubenetes V2 (Elite Portal)": https://nubenetes.com/v2/
  - Home: index.md
  - Intro:
    - Microservice Architecture. From Java EE To Cloud Native. Openshift VS Kubernetes: introduction.md
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -1,5 +1,5 @@
 site_name: Nubenetes
-site_url: https://nubenetes.com/v1/
+site_url: https://nubenetes.com/
 site_description: A curated list of awesome IT projects and resources. Inspired by the awesome list.
 site_author: "Nubenetes"
 docs_dir: docs/
@@ -99,7 +99,7 @@ markdown_extensions:
  - abbr
  - def_list
 nav:
-  - "🚀 Try Nubenetes V2 (Elite Portal)": https://nubenetes.com/
+  - "🚀 Try Nubenetes V2 (Elite Portal)": https://nubenetes.com/v2/
  - Home: index.md
  - Intro:
    - Microservice Architecture. From Java EE To Cloud Native. Openshift VS Kubernetes: introduction.md
@@ -294,7 +294,7 @@ nav:
 copyright: 2026 <a href="https://twitter.com/nubenetes">Nubenetes</a>, <a href="https://nubenetes.com/about/">about</a>.
 extra:
  announce: >-
-    <b>🚀 New!</b> Discover the <a href="https://nubenetes.com/"><b>V2 Elite Portal</b></a> featuring the most premium resources and a renewed design.
+    <b>🚀 New!</b> Discover the <a href="https://nubenetes.com/v2/"><b>V2 Elite Portal</b></a> featuring the most premium resources and a renewed design.
  analytics:
    provider: google
    property: !ENV GOOGLE_ANALYTICS_KEY
--- a/v2-mkdocs.yml
+++ b/v2-mkdocs.yml
@@ -1,5 +1,5 @@
 site_name: "Nubenetes V2 | The AI's Cut"
-site_url: "https://nubenetes.com/"
+site_url: "https://nubenetes.com/v2/"
 site_description: "Enterprise-grade curated portal for the modern Cloud Native ecosystem. High-density, AI-driven selection of top-tier resources."
 site_author: "Nubenetes"
 copyright: "Copyright &copy; 2026 Nubenetes Agentic Intelligence"
@@ -96,7 +96,7 @@ markdown_extensions:
  - pymdownx.mark

 nav:
-  - "🔙 Back to V1 (Exhaustive Archive)": https://nubenetes.com/v1/
+  - "🔙 Back to V1 (Exhaustive Archive)": https://nubenetes.com/
  - "The 2026 Vision": index.md
  - "Agentic Video Hub": videos.md
  - "AI":