From 18a0979aaa6a5b86e1a9dfc8a8a48aacca609b50 Mon Sep 17 00:00:00 2001
From: Natalia Portillo <claunia@claunia.com>
Date: Fri, 26 Jun 2026 12:10:17 +0100
Subject: [PATCH] Update documentations.

---
 .claude/CLAUDE.md | 4 ++--
 AGENTS.md         | 6 ++----
 README.md         | 8 ++++----
 3 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index 8f571e66..1beb4084 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -9,12 +9,12 @@ This document describes Claude Code automation for the Marechai computing histor
 - **Marechai.Server**: ASP.NET Core Web API backend with OpenAPI documentation
 - **Marechai.Database**: Entity Framework Core data access layer with MySQL/MariaDB
 - **Marechai.App**: Uno Platform cross-platform client (Android, iOS, WASM, Desktop)
-- **Marechai** (legacy): Original Blazor Server web application
+- **Marechai** (principal): Original Blazor Server web application
 - Supporting projects: Email, Translation, MobyGames, WinWorld integrations
 
 ### Key Technologies
 
-- **.NET 10.0** (prerelease, see `global.json`)
+- **.NET 10.0**
 - **Entity Framework Core 9.x** with **Pomelo MySQL** provider
 - **Uno Platform SDK 6.5.36** for cross-platform UI
 - **ASP.NET Core Identity** + JWT Bearer authentication
diff --git a/AGENTS.md b/AGENTS.md
index a07116f6..aa2ee982 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -31,7 +31,7 @@ Marechai.slnx
 
 ## Technology Stack
 
-- **.NET 10.0** (Preview/Prerelease)
+- **.NET 10.0**
 - **Uno Platform SDK 6.4.24** for cross-platform development
 - **Entity Framework Core 9.x** with Pomelo MySQL provider
 - **ASP.NET Core Identity** for authentication
@@ -48,7 +48,7 @@ Marechai.slnx
 - .NET 10.0 SDK (with prerelease allowed per `global.json`)
 - Uno Platform SDK 6.4.24
 - MariaDB or MySQL database
-- ImageMagick with HEIF, WebP and AVIF support (in PATH)
+- ImageMagick with WebP and AVIF support (in PATH)
 
 ### Configuration
 
@@ -129,5 +129,3 @@ Test results are stored in the `TestResults/` directory.
    - Update DTOs in `Marechai.Data/` if needed
 
 4. Package versions are centrally managed - update `Directory.Packages.props` when adding/updating packages.
-
-5. The project targets .NET 10.0 preview - be aware of potential API changes.
diff --git a/README.md b/README.md
index a60d0294..601f1c47 100644
--- a/README.md
+++ b/README.md
@@ -89,8 +89,8 @@ The solution is organized as a set of related projects, each with a clear respon
 
 ```text
 Marechai.slnx
-├── Marechai/              # Legacy Blazor Server web application
-├── Marechai.App/          # Uno Platform cross-platform client
+├── Marechai/              # Main Blazor Server web application
+├── Marechai.App/          # Experimental Uno Platform cross-platform client
 ├── Marechai.Server/       # ASP.NET Core API backend
 ├── Marechai.Database/     # EF Core data models, migrations, and data access
 ├── Marechai.Data/         # Shared DTOs, enums, and contracts
@@ -107,13 +107,13 @@ Marechai.slnx
 
 This is the main web application, built with Blazor Server and MudBlazor.
 
-It is the legacy but still important presentation layer for the catalog, especially for administrative workflows, content browsing, and the public-facing web experience.
+It is the main presentation layer for the catalog, especially for administrative workflows, content browsing, and the public-facing web experience.
 
 ### Marechai.App
 
 This is the modern cross-platform client built with Uno Platform.
 
-It targets desktop, mobile, and web scenarios with a shared UI and a responsive design approach. The app is intended to provide a smoother, more flexible experience for users who want to browse the catalog outside the browser.
+It targets desktop, mobile, and web scenarios with a shared UI and a responsive design approach. The app is intended to provide a smoother, more flexible experience for users who want to browse the catalog outside the browser. It is still in an experimental phase, but it is a key part of the long-term vision for the project.
 
 ### Marechai.Server