Merge pull request #249 from nubenetes/develop

feat: final hybrid sync and bump to 2.3.2
feat: finalize hybrid architecture synchronization and bump to 2.3.2 [skip ci]
2026-09-01 08:07:19 +00:00 · 2026-05-26 01:32:55 +02:00 · 2026-05-26 01:31:28 +02:00 · 2026-05-26 01:26:31 +02:00 · 2026-05-25 23:26:17 +00:00 · 2026-05-26 01:25:43 +02:00
11 changed files with 127 additions and 30 deletions
@@ -35,14 +35,39 @@ jobs:
        run: |
          pip install -r requirements.txt

-      # 1. Build V1 (Root)
-      - name: Build V1 Edition
-        run: mkdocs build -f mkdocs.yml -d site/
+      # 1. Build V1 to a temporary staging area
+      - name: Build V1 Edition (Staging)
+        run: mkdocs build -f mkdocs.yml -d site_v1_temp/

-      # 2. Build V2 (Subdirectory)
+      # 2. Deploy V1 to Root (SEO) and /v1/ (Fallback)
+      - name: Deploy V1 to Root and Subdirectory
+        run: |
+          mkdir -p site/v1/
+          cp -r site_v1_temp/* site/
+          cp -r site_v1_temp/* site/v1/
+          rm -rf site_v1_temp/
+
+      # 3. Build V2 Elite Edition (/v2/)
      - name: Build V2 Elite Edition
        run: mkdocs build -f v2-mkdocs.yml -d site/v2/

+      # 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

@@ -5,6 +5,46 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

+## [[2.3.2]](https://github.com/nubenetes/awesome-kubernetes/releases/tag/v2.3.2) - 2026-05-25
+
+### Changed
+- **Hybrid Sync Standardization**: Unified navigation labels and URLs across `v2-mkdocs.yml` and `src/v2_optimizer.py`. The "Back to V1" link now consistently points to the domain root to leverage SEO-protected legacy paths.
+
+## [[2.3.1]](https://github.com/nubenetes/awesome-kubernetes/releases/tag/v2.3.1) - 2026-05-25
+
+### Fixed
+- **Deployment Resilience**: Resolved a recursive copy error in the GitHub Pages deployment workflow by implementing a temporary staging area for the V1 build process.
+
+## [[2.3.0]](https://github.com/nubenetes/awesome-kubernetes/releases/tag/v2.3.0) - 2026-05-25
+
+### Added
+- **Hybrid SEO-First Architecture**: Implemented a sophisticated dual-version deployment strategy. V1 is restored to the domain root (`/`) to preserve 6+ years of SEO authority and deep-links, while a root-level redirect guides human traffic to the modern V2 Elite Portal at `/v2/`.
+
+## [[2.2.4]](https://github.com/nubenetes/awesome-kubernetes/releases/tag/v2.2.4) - 2026-05-25
+
+### Changed
+- **Governance & Documentation Sync**: Performed a comprehensive update of `README.md`, `GEMINI.md`, and local session memory to reflect the new architectural standards (V2 at Root), workflow hardening (rebase resilience), and mandatory PR-based governance for production deployments.
+
+## [[2.2.3]](https://github.com/nubenetes/awesome-kubernetes/releases/tag/v2.2.3) - 2026-05-25
+
+### Fixed
+- **Redirect Collision Resolution**: Removed conflicting HTML redirects in the V2 portal that were blocking access to new Elite content with the same filenames as legacy pages.
+- **SEO Mitigation Refinement**: Shifted to a "Smart 404" only strategy for the root domain, ensuring that URLs like `kubernetes.html` serve the updated V2 content while missing legacy links are elegantly handled by the custom 404 page.
+
+## [[2.2.2]](https://github.com/nubenetes/awesome-kubernetes/releases/tag/v2.2.2) - 2026-05-25
+
+### Added
+- **SEO Mitigation (Smart 404)**: Implemented a custom 404 page in the V2 portal (`404.md`) to guide users from broken historical links to the new V1 archive location.
+- **HTML Redirects**: Integrated the `mkdocs-redirects` plugin and configured 301-style HTML redirects for the top 12 legacy URLs, preserving search engine authority and user experience during the root migration.
+
+## [[2.2.1]](https://github.com/nubenetes/awesome-kubernetes/releases/tag/v2.2.1) - 2026-05-25
+
+### Changed
+- **Default Landing Page (V2 at Root)**: Promoted the Nubenetes Elite Portal (V2) to the root of the domain (`https://nubenetes.com/`) to provide a modern, AI-curated default experience.
+- **V1 Archive Relocation**: Moved the exhaustive V1 archive to the `/v1/` subdirectory (`https://nubenetes.com/v1/`).
+- **Navigation Synchronization**: Updated all navigation links and announce banners across both versions to ensure seamless switching between the Elite Portal and the Exhaustive Archive.
+- **Workflow Realignment**: Reconfigured the GitHub Pages deployment pipeline to support the new directory structure while maintaining zero-downtime synchronization.
+
 ## [[2.2.0]](https://github.com/nubenetes/awesome-kubernetes/releases/tag/v2.2.0) - 2026-05-25

 ### Fixed
@@ -360,16 +360,15 @@ The bot must rotate between profiles to avoid detection:
    - **Announce Banner**: Added a global announcement banner to V1 directing users to the V2 Elite Portal.
    - **Resilient Architectural Refinements (Phase 2)**:
        - **Fast-Track V2 Elite Builder**: Optimized the builder to run sequentially for maximum stability and simplicity, bypassing the overhead of distributed systems.
-        - **Pip Caching**: Implemented `cache: pip` across all 5 workflows to drastically reduce startup times and compute minutes.
-        - **Contribution Template (PR Guardian)**: Enforced strict GEMINI mandate compliance at the PR creation stage via `PULL_REQUEST_TEMPLATE.md`.
-        - **Exponential Backoff Resilience**: Upgraded the `call_gemini_with_retry` engine with the `tenacity` library, allowing intelligent pausing (4s, 8s, 16s) to gracefully absorb 429 Rate Limits before triggering the ultimate exit code 42 Circuit Breaker.
-        - **Ultra-Fast V2 Render Mode**: Optimized the `render-and-pr` stage of the V2 pipeline (`--render-only`) to implement an absolute short-circuit, completely bypassing redundant HTTP health checks, GitHub API metadata fetching, and AI agent evaluation loops. This leverages the pre-computed YAML inventory to assemble the portal instantaneously.
-        - **Flash-First Architecture Transition (May 2026)**:
-            - **Throughput Optimization**: Successfully transitioned to a Flash-First architecture, increasing Fast-Track batch sizes to 100 resources.
-            - **Resilience Hardening**: Improved error handling to ensure Rate-Limit (429) events trigger the Circuit Breaker instead of silent loops, preserving API integrity.
-            - **Efficiency Gains**: Reduced expected execution time for 10k+ resources by >60% through optimized RPM/TPM management and strategic safety delays.
-
-
+        - **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 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.
@@ -140,7 +140,7 @@ Additionally, as of May 2026, Nubenetes has reached the **Platinum Operational T
 | :--- | :--- |
 | **Total Technical Resources (Links)** | **17992+** |
 | **Specialized MD Pages** | **161** |
-| **Total Commits** | **5473+** |
+| **Total Commits** | **5488+** |
 | **Primary AI Engine** | **Google Gemini (Agentic)** |
 <!-- HEART_STATS_END -->

@@ -178,7 +178,7 @@ The growth of Nubenetes reflects the acceleration of the Cloud Native ecosystem.
 | 6 | 2023 | 30 | 123 | Maintenance & Refinement |
 | 7 | 2024 | 53 | 218 | Curation Strategy Pivot |
 | 8 | 2025 | 5 | 20 | Stability & Research Phase |
-| 9 | 2026 | 1914 | 7,904 | **Agentic AI Surge** (May 2026 Inception) |
+| 9 | 2026 | 1929 | 7,966 | **Agentic AI Surge** (May 2026 Inception) |
 <!-- ANNUAL_GROWTH_END -->

 <!-- ANNUAL_CHART_START -->
@@ -194,8 +194,8 @@ xychart-beta
    title "Nubenetes Annual Growth Metrics (2018–2026)"
    x-axis ["2018", "2019", "2020", "2021", "2022", "2023", "2024", "2025", "2026"]
    y-axis "Volume (Commits / Estimated New Refs)" 0 --> 9000
-    bar [1445, 586, 8449, 2193, 1660, 123, 218, 20, 7904]
-    bar [350, 142, 2046, 531, 402, 30, 53, 5, 1914]
+    bar [1445, 586, 8449, 2193, 1660, 123, 218, 20, 7966]
+    bar [350, 142, 2046, 531, 402, 30, 53, 5, 1929]
 ```
 <!-- ANNUAL_CHART_END -->

@@ -204,7 +204,7 @@ xychart-beta
 | Month | Commits | Est. New Refs | Status |
 | :--- | :---: | :---: | :--- |
 | 2026-04 | 25 | 103 | Active Curation |
-| 2026-05 | 1889 | 7,801 | **Agentic Inception (Gemini Era)** |
+| 2026-05 | 1904 | 7,863 | **Agentic Inception (Gemini Era)** |
 <!-- MONTHLY_SURGE_END -->

 ### 2.4. Content Distribution and Semantic Clustering
@@ -340,12 +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](https://nubenetes.com)

 ### 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 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):**
@@ -903,10 +905,11 @@ graph LR
    B --> D["V2 Vision Engine"]
    B --> Z["README Sync"]
    D --> E["V2 Update (develop)"]
-    E --> M["Sync to 'master'"]
-    M --> C["Pip Cache & CI/CD Build"]
+    M["Sync to 'master'"] --> C["Pip Cache & CI/CD Build"]
    C --> F["Upload Pages Artifact"]
-    F --> G["Native Deploy to nubenetes.com"]
+    F --> G["Native Deploy: V1 (Root/SEO), V2 (/v2/), V1 Fallback (/v1/)"]
+    G --> H["Inject Root Redirect to /v2/"]
+    Z --> B
    Z --> B
 ```

@@ -1000,7 +1003,7 @@ To maintain transparency and ease of navigation, all key configuration, database
 - **Link Rules:** [`data/link_rules.yaml`](data/link_rules.yaml) - Defines strictness for URL transformations and deep-link preservation.
 - **Curation Sources:** [`data/curation_sources.yaml`](data/curation_sources.yaml) - Defines monitored X.com accounts and technical topics.
 - **Special Assets:** [`data/special_assets.yaml`](data/special_assets.yaml) - VIP logic orchestration.
- **Site Config:** [V1 (mkdocs.yml)](mkdocs.yml), [V2 (v2-mkdocs.yml)](v2-mkdocs.yml).
+- **Site Config:** [V1 (mkdocs.yml)](mkdocs.yml), [V2 (v2-mkdocs.yml)](v2-mkdocs.yml). Uses `favicon-ultra.png` for visibility and `hero-car.png` for branding.

 ### 13.2. Centralized Metadata Databases
 - **Global Inventory:** [`data/inventory.yaml`](data/inventory.yaml) - The "System Memory" containing all link metadata (years, stars, descriptions, and audit history).
@@ -1082,3 +1085,4 @@ The technical resources (links, articles, videos) curated in this archive are th

 ### 15.3. Legal Disclaimer
 The information provided in this repository is for educational and professional reference purposes only. While our Agentic AI ensures high-fidelity curation, users should verify production configurations against official vendor documentation (AWS, Red Hat, CNCF) before deployment.
+r educational and professional reference purposes only. While our Agentic AI ensures high-fidelity curation, users should verify production configurations against official vendor documentation (AWS, Red Hat, CNCF) before deployment.
@@ -0,0 +1,11 @@
+<!DOCTYPE html>
+<html lang=en>
+  <meta charset=utf-8>
+  <meta name=viewport content="initial-scale=1, minimum-scale=1, width=device-width">
+  <title>Error 400 (Bad Request)!!1</title>
+  <style>
+    *{margin:0;padding:0}html,code{font:15px/22px arial,sans-serif}html{background:#fff;color:#222;padding:15px}body{margin:7% auto 0;max-width:390px;min-height:180px;padding:30px 0 15px}* > body{background:url(//www.google.com/images/errors/robot.png) 100% 5px no-repeat;padding-right:205px}p{margin:11px 0 22px;overflow:hidden}ins{color:#777;text-decoration:none}a img{border:0}@media screen and (max-width:772px){body{background:none;margin-top:0;max-width:none;padding-right:0}}#logo{background:url(//www.google.com/images/branding/googlelogo/1x/googlelogo_color_150x54dp.png) no-repeat;margin-left:-5px}@media only screen and (min-resolution:192dpi){#logo{background:url(//www.google.com/images/branding/googlelogo/2x/googlelogo_color_150x54dp.png) no-repeat 0% 0%/100% 100%;-moz-border-image:url(//www.google.com/images/branding/googlelogo/2x/googlelogo_color_150x54dp.png) 0}}@media only screen and (-webkit-min-device-pixel-ratio:2){#logo{background:url(//www.google.com/images/branding/googlelogo/2x/googlelogo_color_150x54dp.png) no-repeat;-webkit-background-size:100% 100%}}#logo{display:inline-block;height:54px;width:150px}
+  </style>
+  <a href=//www.google.com/><span id=logo aria-label=Google></span></a>
+  <p><b>400.</b> <ins>That’s an error.</ins>
+  <p>Your client has issued a malformed or illegal request.  <ins>That’s all we know.</ins>
@@ -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**](/v2) - 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.

@@ -1,5 +1,5 @@
 site_name: Nubenetes
-site_url: https://nubenetes.com
+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/
@@ -13,7 +13,7 @@ theme:
  icon:
    logo: logo
    repo: fontawesome/brands/github
-  favicon: images/favicon-car-modern.png
+  favicon: images/favicon-ultra.png
  palette:
    - scheme: default
      primary: indigo
@@ -85,6 +85,7 @@ markdown_extensions:
  - abbr
  - def_list
 nav:
+  - "🚀 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
@@ -1,5 +1,5 @@
 site_name: Nubenetes
-site_url: https://nubenetes.com
+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)": https://nubenetes.com/v2/
+  - "🚀 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
@@ -2,3 +2,5 @@ mkdocs-material>=9.5.0
 pymdown-extensions>=10.8.1
 yt-dlp
 youtube-transcript-api
+mkdocs-redirects>=1.2.0
+mkdocs-minify-plugin>=0.8.0
@@ -0,0 +1,13 @@
+# 404 - Knowledge Not Found
+
+<center markdown="1">
+![Not Found](images/hero-car.png)
+
+## Did you get lost in the Cloud?
+
+Nubenetes has recently upgraded to its **V2 Elite Agentic Portal**. If you clicked on an old link, the content you are looking for has been moved to our **Exhaustive V1 Archive**.
+
+[🚀 Go to the V1 Exhaustive Archive](https://nubenetes.com/v1/)
+
+[🔙 Return to the V2 Home Page](/)
+</center>
@@ -57,6 +57,8 @@ theme:
        font_family: "Inter"
      custom_dir: "docs/images/"
      logo: favicon-ultra.png
+  - redirects:
+      redirect_maps: {}

 extra:
  social:
Author	SHA1	Message	Date
Inaki	baa5e50169	Merge pull request #249 from nubenetes/develop feat: final hybrid sync and bump to 2.3.2	2026-05-26 01:32:55 +02:00
Nubenetes Bot	9e93630751	feat: finalize hybrid architecture synchronization and bump to 2.3.2 [skip ci]	2026-05-26 01:31:28 +02:00
Inaki	19d64980ad	Merge pull request #248 from nubenetes/develop fix: deployment workflow recursion and version 2.3.1	2026-05-26 01:26:31 +02:00
Nubenetes Bot	cf339f0c46	docs: automated README metric synchronization [skip ci]	2026-05-25 23:26:17 +00:00
Nubenetes Bot	20804b469f	fix: resolve recursive copy error in deployment workflow and bump to 2.3.1	2026-05-26 01:25:43 +02:00
Inaki	0035453719	Merge pull request #247 from nubenetes/develop feat: Hybrid SEO-First architecture and version 2.3.0	2026-05-26 01:23:26 +02:00
Nubenetes Bot	515fa782cc	feat: revert to Hybrid SEO-First architecture (V1 at Root, V2 at /v2/) [skip ci]	2026-05-26 01:22:34 +02:00
Inaki	954beb9cbc	Merge pull request #246 from nubenetes/develop docs: comprehensive documentation sync and bump to 2.2.4	2026-05-26 00:38:48 +02:00
Nubenetes Bot	8c69b935ba	docs: exhaustive synchronization of governance and architecture standards [skip ci]	2026-05-26 00:38:07 +02:00
Inaki	1fd77d6c69	Merge pull request #245 from nubenetes/develop fix: SEO mitigation for V2 root deployment	2026-05-26 00:36:03 +02:00
Nubenetes Bot	85a1cedf01	docs: automated README metric synchronization [skip ci]	2026-05-25 22:35:36 +00:00
Nubenetes Bot	470059e59f	fix: resolve redirect collision and restore access to V2 pages, bump to 2.2.3	2026-05-26 00:35:02 +02:00
Nubenetes Bot	b9cc8065c5	docs: automated README metric synchronization [skip ci]	2026-05-25 22:32:49 +00:00
Nubenetes Bot	76318ccb83	fix: implement SEO mitigation via redirects and smart 404 and bump to 2.2.2	2026-05-26 00:32:08 +02:00
Inaki	a85ee3c23c	Merge pull request #244 from nubenetes/develop feat: V2 root deployment and version 2.2.1	2026-05-26 00:09:23 +02:00
Nubenetes Bot	33e364effe	docs: synchronize README with V2 root deployment architecture [skip ci]	2026-05-26 00:07:58 +02:00
Nubenetes Bot	0d9eb6334e	feat: promote V2 Elite Portal to root and move V1 to /v1/ [skip ci]	2026-05-26 00:06:02 +02:00