From 260e22037adb8642def97e067ca11bbc527232d5 Mon Sep 17 00:00:00 2001 From: Nubenetes Bot Date: Tue, 19 May 2026 13:29:09 +0200 Subject: [PATCH] docs: document semantic cross-linking, multi-tagging and industrial learning flow mandates --- GEMINI.md | 3 +++ README.md | 2 ++ 2 files changed, 5 insertions(+) diff --git a/GEMINI.md b/GEMINI.md index 7c78543c..819b8ab3 100644 --- a/GEMINI.md +++ b/GEMINI.md @@ -124,6 +124,9 @@ This file contains the accumulated instructions and long-term vision for the aut - **Gold Resources (4 stars)**: Use bold formatting for the link text (e.g., `**[Link Title]**`). - **Multi-Dimensional Tagging**: Every resource in V2 SHOULD have one or more maturity/type tags (e.g., `[DE FACTO STANDARD]`, `[GUIDE]`, `[CASE STUDY]`). The `[COMMUNITY-TOOL]` tag is the fallback for unclassified assets. - **Star Consistency**: Maintain the 1-5 star scale for technical impact. Resources with 0 stars are considered "Standard References" and do not display a star prefix/suffix in the V2 UI. +38. **V2 Semantic Connectivity**: All V2 content generation MUST implement the **Semantic Cross-Linking Engine**. AI agents must autonomously identify related architectural patterns within the same strategic dimension and inject "💡 Explore Related" navigation blocks at the end of sections to facilitate a connected knowledge graph. +39. **Industrial Learning Flow**: V2 documents MUST follow an O'Reilly-style technical progression. Organization within sections must move from foundational theory and standards to advanced implementation details and emerging patterns. +40. **Autonomous Multi-Tagging**: Every resource evaluation MUST assign at least one maturity tag and one resource-type tag if applicable. Fallback to `[COMMUNITY-TOOL]` is only permitted after exhaustive classification failure. 37. **Linguistic Uniformity**: All core documentation (index, README, GEMINI.md) and V2 portal summaries MUST be written in **Professional Technical English**. V1 descriptions remain in their native language (Mandate 10). ## 🛠️ Structural Evolution & Navigation diff --git a/README.md b/README.md index b10ea570..94153df9 100644 --- a/README.md +++ b/README.md @@ -336,6 +336,8 @@ Nubenetes operates with two distinct editions to serve different engineering nee - **`**Bold Text**`**: **Gold Standard** (4 stars) – Highly recommended resources with strong industry momentum. - **Stars (🌟)**: Represent technical impact (1-5 scale). - **No stars**: Standard reference documentation and technical resources. +- **Multi-Dimensional Tagging (1:N):** Every resource is classified with multiple semantic tags (e.g., `[DE FACTO STANDARD]`, `[GUIDE]`, `[CASE STUDY]`, `[EMERGING]`) providing deep technical context and maturity status. +- **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/v2/](https://nubenetes.com/v2/)