Update docs validation scripts and workflow to include docs/website/docs; sync outdated content

Co-authored-by: efargas <9705611+efargas@users.noreply.github.com>
Agent-Logs-Url: https://github.com/efargas/S7-Tools/sessions/82584976-33f7-4244-86f6-3b58a2a12701

Author: Copilot

.github/workflows/docs-validation.yml

@@ -30,8 +30,12 @@ jobs:
       - name: Install markdownlint-cli
         run: npm install -g markdownlint-cli
 
-      - name: Run markdown linting
-        run: markdownlint 'docs/**/*.md' --ignore 'docs/.metadata/**' --ignore 'docs/archive/**'
+      - name: Run markdown linting (docs/)
+        run: markdownlint 'docs/**/*.md' --ignore 'docs/.metadata/**' --ignore 'docs/archive/**' --ignore 'docs/website/**'
+        continue-on-error: true
+
+      - name: Run markdown linting (docs/website/docs/)
+        run: markdownlint 'docs/website/docs/**/*.md' --ignore 'docs/website/docs/archive/**' --ignore 'docs/website/docs/external/**'
         continue-on-error: true
 
   frontmatter-validation:
@@ -49,9 +53,12 @@ jobs:
       - name: Install Python dependencies
         run: pip install pyyaml
 
-      - name: Validate frontmatter
+      - name: Validate frontmatter (docs/)
         run: python scripts/validate-frontmatter.py docs/
 
+      - name: Validate frontmatter (docs/website/docs/)
+        run: python scripts/validate-frontmatter.py docs/website/docs/
+
   link-validation:
     name: Link Validation (BLOCKING)
     runs-on: ubuntu-latest
@@ -67,9 +74,13 @@ jobs:
       - name: Install markdown-link-check
         run: npm install -g markdown-link-check
 
-      - name: Check links in documentation
+      - name: Check links in documentation (docs/)
+        run: |
+          find docs -name "*.md" -not -path "docs/.metadata/*" -not -path "docs/website/*" -not -path "docs/website" -exec markdown-link-check --config .markdown-link-check.json {} \;
+
+      - name: Check links in website documentation (docs/website/docs/)
         run: |
-          find docs -name "*.md" -not -path "docs/.metadata/*" -exec markdown-link-check --config .markdown-link-check.json {} \;
+          find docs/website/docs -name "*.md" -not -path "docs/website/docs/external/*" -exec markdown-link-check --config .markdown-link-check.json {} \;
 
   orphan-detection:
     name: Orphan Detection (WARNING)
@@ -89,10 +100,14 @@ jobs:
       - name: Create output directory
         run: mkdir -p docs/.metadata/reports
 
-      - name: Detect orphaned files
+      - name: Detect orphaned files (docs/)
         run: python scripts/detect-orphans.py docs/ --report
         continue-on-error: true
 
+      - name: Detect orphaned files (docs/website/docs/)
+        run: python scripts/detect-orphans.py docs/website/docs/ --report
+        continue-on-error: true
+
       - name: Upload orphan report
         if: always()
         uses: actions/upload-artifact@v4
@@ -129,10 +144,46 @@ jobs:
           path: docs/.metadata/reports/duplicates.csv
           if-no-files-found: ignore
 
+  website-docs-validation:
+    name: Website Docs Source Validation (WARNING)
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install Python dependencies
+        run: pip install pyyaml colorama
+
+      - name: Create output directory
+        run: mkdir -p docs/.metadata/website
+
+      - name: Validate website docs against source code
+        run: |
+          python scripts/validate-documentation.py \
+            --docs-path docs/website/docs \
+            --skip-compilation \
+            --output docs/.metadata/website
+        continue-on-error: true
+
+      - name: Upload website validation report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: website-docs-validation-report
+          path: docs/.metadata/website/
+          if-no-files-found: ignore
+
   validation-summary:
     name: Validation Summary
     runs-on: ubuntu-latest
-    needs: [frontmatter-validation, link-validation, orphan-detection, duplicate-detection]
+    needs: [frontmatter-validation, link-validation, orphan-detection, duplicate-detection, website-docs-validation]
     if: always()
     steps:
       - name: Check validation results
@@ -144,6 +195,7 @@ jobs:
           echo "Link Validation: ${{ needs.link-validation.result }}"
           echo "Orphan Detection: ${{ needs.orphan-detection.result }} (non-blocking)"
           echo "Duplicate Detection: ${{ needs.duplicate-detection.result }} (non-blocking)"
+          echo "Website Docs Validation: ${{ needs.website-docs-validation.result }} (non-blocking)"
           echo ""
           if [ "${{ needs.frontmatter-validation.result }}" != "success" ] || [ "${{ needs.link-validation.result }}" != "success" ]; then
             echo "❌ VALIDATION FAILED: Please fix frontmatter and link errors before merging."

docs/website/docs/README.md

@@ -10,7 +10,6 @@ tags:
 - navigation
 - readme
 related:
-- docs/INDEX.md
 - docs/guides/ai-agent-guide.md
 - docs/guides/onboarding.md
 ---

docs/website/docs/architecture/_index.md

@@ -6,7 +6,6 @@ last-updated: "2025-11-10"
 status: "current"
 tags: ["architecture", "index", "navigation"]
 related:
-  - "docs/INDEX.md"
   - "docs/architecture/overview.md"
   - "docs/patterns/_index.md"
 supersedes: []

docs/website/docs/architecture/project-brief.md

@@ -52,8 +52,8 @@ Build a professional-grade desktop application for **Siemens S7-1200 PLC memory
 ## Technology Foundation
 
 ### Core Stack
-- **.NET 8.0** - Latest C# language features and performance
-- **Avalonia UI 11.3.6** - Cross-platform XAML framework
+- **.NET 10.0** - Latest C# language features and performance
+- **Avalonia UI 11.3.12** - Cross-platform XAML framework
 - **ReactiveUI 20.1.1** - Reactive MVVM implementation
 - **Microsoft.Extensions.*** - Logging, DI, and hosting
 

docs/website/docs/architecture/technology-stack.md

@@ -1,8 +1,8 @@
 ---
 title: "Technology Stack"
-version: "1.0.0"
+version: "1.1.0"
 created: "2025-11-11"
-last-updated: "2025-11-11"
+last-updated: "2026-03-24"
 status: "current"
 tags: ["architecture", "technology", "stack", "libraries"]
 related:
@@ -20,8 +20,8 @@ related:
 
 ### **Core Technologies**
 
-#### **.NET 8.0**
-- **Version**: 8.0 (Latest LTS)
+#### **.NET 10.0**
+- **Version**: 10.0
 - **Language**: C# with latest language features
 - **Features Used**:
   - Nullable reference types enabled
@@ -30,7 +30,7 @@ related:
   - Pattern matching enhancements
   - Record types for data models
 
-#### **Avalonia UI 11.3.6**
+#### **Avalonia UI 11.3.12**
 - **Purpose**: Cross-platform desktop UI framework
 - **Advantages**:
   - Cross-platform (Windows, Linux, macOS)
@@ -64,7 +64,7 @@ related:
 - **Custom Integration**: DataStore provider for UI logging
 - **Providers**: Console, Debug, and custom DataStore
 
-#### **CommunityToolkit.Mvvm 8.2.0**
+#### **CommunityToolkit.Mvvm 8.4.0**
 - **Purpose**: Additional MVVM helpers and source generators
 - **Usage**: Complementary to ReactiveUI for specific scenarios
 
@@ -98,7 +98,7 @@ related:
 ### **Prerequisites**
 
 #### **Required Software**
-- **.NET 8.0 SDK** or later
+- **.NET 10.0 SDK** or later
 - **Git** for version control
 - **IDE** (Visual Studio 2022, Rider, or VS Code)
 
@@ -172,7 +172,7 @@ dotnet test
 - **Tertiary**: macOS (10.15+, x64/ARM64)
 
 #### **Runtime Requirements**
-- **.NET 8.0 Runtime** (Desktop)
+- **.NET 10.0 Runtime** (Desktop)
 - **Minimum RAM**: 512MB
 - **Minimum Storage**: 100MB
 - **Display**: 1024x768 minimum resolution
@@ -211,25 +211,36 @@ dotnet test
 
 #### **S7Tools Project**
 ```xml
-<PackageReference Include="Avalonia" Version="11.3.6" />
-<PackageReference Include="Avalonia.Desktop" Version="11.3.6" />
-<PackageReference Include="Avalonia.ReactiveUI" Version="11.3.6" />
-<PackageReference Include="Avalonia.Themes.Fluent" Version="11.3.6" />
-<PackageReference Include="Avalonia.Fonts.Inter" Version="11.3.6" />
-<PackageReference Include="Avalonia.Controls.DataGrid" Version="11.3.6" />
+<PackageReference Include="Avalonia" Version="11.3.12" />
+<PackageReference Include="Avalonia.Desktop" Version="11.3.12" />
+<PackageReference Include="AvaloniaHex" Version="0.1.10" />
+<PackageReference Include="Avalonia.ReactiveUI" Version="11.3.8" />
+<PackageReference Include="Avalonia.Themes.Fluent" Version="11.3.12" />
+<PackageReference Include="Avalonia.Fonts.Inter" Version="11.3.12" />
+<PackageReference Include="Avalonia.Controls.DataGrid" Version="11.3.12" />
+<PackageReference Include="Avalonia.Xaml.Interactivity" Version="11.3.0.6" />
+<PackageReference Include="Dock.Avalonia" Version="11.3.11.22" />
+<PackageReference Include="Dock.Avalonia.Themes.Fluent" Version="11.3.11.22" />
+<PackageReference Include="Dock.Model.Mvvm" Version="11.3.11.22" />
 <PackageReference Include="ReactiveUI" Version="20.1.1" />
+<PackageReference Include="Splat.Microsoft.Extensions.DependencyInjection" Version="14.8.6" />
 <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="8.0.0" />
 <PackageReference Include="Microsoft.Extensions.Logging" Version="8.0.0" />
-<PackageReference Include="CommunityToolkit.Mvvm" Version="8.2.0" />
+<PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="8.0.0" />
+<PackageReference Include="Microsoft.Extensions.Configuration.Json" Version="10.0.5" />
+<PackageReference Include="CommunityToolkit.Mvvm" Version="8.4.0" />
 <PackageReference Include="Projektanker.Icons.Avalonia.FontAwesome" Version="9.6.2" />
 <PackageReference Include="FluentAvaloniaUI" Version="2.4.0" />
+<PackageReference Include="System.IO.Ports" Version="8.0.0" />
+<PackageReference Include="NModbus" Version="3.0.72" />
 ```
 
 #### **S7Tools.Infrastructure.Logging Project**
 ```xml
 <PackageReference Include="Microsoft.Extensions.Logging" Version="8.0.0" />
 <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="8.0.0" />
-<PackageReference Include="System.Collections.Concurrent" Version="8.0.0" />
+<PackageReference Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="8.0.0" />
+<PackageReference Include="Microsoft.Extensions.Options" Version="8.0.0" />
 ```
 
 #### **S7Tools.Core Project**
@@ -291,7 +302,7 @@ dotnet test
 dotnet publish src/S7Tools/S7Tools.csproj -c Release
 ```
 - **Advantages**: Smaller package size
-- **Requirements**: .NET 8.0 Runtime must be installed
+- **Requirements**: .NET 10.0 Runtime must be installed
 - **Use Case**: Corporate environments with managed runtimes
 
 #### **Self-Contained Deployment**

docs/website/docs/archive/_index.md

@@ -6,7 +6,6 @@ last-updated: "2025-11-12"
 status: "current"
 tags: ["archive", "index", "deprecated"]
 related:
-  - docs/INDEX.md
   - docs/guides/archive-management.md
 ---
 

docs/website/docs/blueprint.md

@@ -2,29 +2,30 @@
 title: "S7Tools Project Architecture and Structure Blueprint"
 version: "1.6.0"
 created: "2025-10-15"
-last-updated: "2026-03-17"
+last-updated: "2026-03-24"
+status: "current"
 tags: ["architecture", "blueprint", "structure", "ai-agent", "guide", "dotnet"]
 ---
 
 # S7Tools Project Architecture and Structure Blueprint
 
 ## 1. Visión General
 
-S7Tools es una aplicación de escritorio multiplataforma avanzada diseñada para el análisis de seguridad, comunicación y volcado de memoria (firmware extraction) de los PLC Siemens S7-1200 mediante acceso por bootloader. Está construida utilizando **.NET 8.0** (con soporte de compilación en SDKs modernos como .NET 10.0), el framework de interfaz gráfica **Avalonia UI** y el patrón MVVM funcional-reactivo provisto por **ReactiveUI**. 
+S7Tools es una aplicación de escritorio multiplataforma avanzada diseñada para el análisis de seguridad, comunicación y volcado de memoria (firmware extraction) de los PLC Siemens S7-1200 mediante acceso por bootloader. Está construida utilizando **.NET 10.0**, el framework de interfaz gráfica **Avalonia UI** y el patrón MVVM funcional-reactivo provisto por **ReactiveUI**. 
 
 El proyecto se adhiere estrictamente a los principios de **Clean Architecture**, asegurando que el Dominio (Core) esté completamente aislado de la Infraestructura (I/O, Logging) y la Presentación (UI). Además, implementa un procesamiento altamente concurrente y seguro mediante la orquestación coordinada de recursos de hardware.
 
 ## 2. Análisis Técnico Detallado
 
 ### Entorno y SDKs
-* **.NET SDK**: 8.0 (LTS) como target principal. El sistema de CI/CD y build tools locales operan bajo SDKs actualizados (se detectan targeting packs de .NET 10.0.4 en los logs de MSBuild).
+* **.NET SDK**: 10.0 como target principal.
 * **Lenguajes**: C# 12/13 (features modernas: Primary Constructors, Records, Nullable Reference Types), C/ARM Assembly (para payloads del PLC), TypeScript/JavaScript (Documentación y scripts de scraping).
 
 ### Dependencias y Paquetes Clave
-* **Avalonia UI (v11.3.6)**: Framework principal para la interfaz de usuario multiplataforma (Windows, Linux, macOS).
+* **Avalonia UI (v11.3.12)**: Framework principal para la interfaz de usuario multiplataforma (Windows, Linux, macOS).
 * **ReactiveUI (v20.1.1)**: Motor MVVM principal, gestión de estado reactivo y comandos asíncronos (`ReactiveCommand`).
 * **Microsoft.Extensions.* (v8.0.0)**: Abstracciones estándar para Inyección de Dependencias (DI), Logging y Options.
-* **CommunityToolkit.Mvvm (v8.2.0)**: Utilizado como soporte complementario para observabilidad y Source Generators en escenarios específicos.
+* **CommunityToolkit.Mvvm (v8.4.0)**: Utilizado como soporte complementario para observabilidad y Source Generators en escenarios específicos.
 * **Dock.Avalonia**: Sistema de docking estilo VSCode (pestañas, paneles anclables) para gestionar el área de trabajo.
 * **AvaloniaHex**: Visor/Editor hexadecimal de alto rendimiento para el análisis de volcados de memoria.
 * **Testing**: xUnit, Moq, NSubstitute, FluentAssertions.
@@ -38,7 +39,7 @@ El proyecto se adhiere estrictamente a los principios de **Clean Architecture**,
 ### Pasos para Configurar y Ejecutar
 
 1. **Requisitos Previos**:
-   * Instalar .NET 8.0 SDK (o superior compatible).
+   * Instalar .NET 10.0 SDK (o superior compatible).
    * Instalar Git.
    * (Opcional) Docker y GCC ARM toolchain para compilar payloads.
 

docs/website/docs/guides/ai-agent-guide.md

@@ -10,7 +10,6 @@ tags:
 - onboarding
 - quick-start
 related:
-- docs/INDEX.md
 - docs/architecture/overview.md
 - docs/patterns/_index.md
 - docs/guides/development-workflow.md

docs/website/docs/guides/archive-management.md

@@ -7,7 +7,6 @@ status: "current"
 tags: ["documentation", "archive", "workflow", "deprecation"]
 related:
   - docs/guides/contributing-to-docs.md
-  - docs/INDEX.md
 ---
 
 # Archive Management Workflow

docs/website/docs/guides/memory-bank-usage.md

@@ -7,7 +7,6 @@ status: "current"
 type: "tutorial"
 tags: ["guide", "documentation", "maintenance", "memory-bank"]
 related:
-  - docs/INDEX.md
   - docs/guides/development-workflow.md
   - docs/architecture/overview.md
 ---