From 788e8b6048e6f434f8a8e53994d3bc9e93a77dff Mon Sep 17 00:00:00 2001
From: FedericoMusa <165095964+FedericoMusa@users.noreply.github.com>
Date: Tue, 24 Feb 2026 17:57:04 -0300
Subject: [PATCH] Doc:Finalice server/simulator narrative

---
 doc/source/server.rst     |  2 ++
 doc/source/simulator3.rst | 18 ++++++++----------
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/doc/source/server.rst b/doc/source/server.rst
index 4260206e0..8a4c92b37 100644
--- a/doc/source/server.rst
+++ b/doc/source/server.rst
@@ -27,5 +27,7 @@ applications to use the server as if it was synchronous.
 
 Datastore for server
 --------------------
+.. note::
+   The legacy datastores will be replaced in v4.0.0 by SimData/SimDevice (already available) to provide a more flexible data definition.
 
 :ref:`Datastore definitions`
diff --git a/doc/source/simulator3.rst b/doc/source/simulator3.rst
index 9bacf4a5f..ffc34a62a 100644
--- a/doc/source/simulator3.rst
+++ b/doc/source/simulator3.rst
@@ -3,18 +3,16 @@ Simulator (3.x)
 
 .. warning:: Beginning with v3.9.0 and ending with v4.0.0 this simulator will be removed by a new version.
 
-The simulator is a full fledged modbus simulator, which is
-constantly being evolved with user ideas / amendments.
+**REMARK**: A simulator is a standard server with an additional http interface.
 
-The purpose of the simulator is to provide support for client
-application test harnesses with end-to-end testing simulating real life
-modbus devices.
+The core logic of the simulator (SimDevice/SimData) is being integrated into the base server to provide a more flexible data definition.
 
-The datastore simulator allows the user to (all automated)
+The purpose of this integration is to provide a flexible data definition for both standard servers and simulation environments.
 
-- simulate a modbus device by adding a simple configuration,
-- test how a client handles modbus exceptions,
-- test a client apps correct use of the simulated device.
+The datamodel allows the user to:
+
+- Define a modbus device using the ``SimDevice`` architecture.
+- Handle data using ``SimData`` with specific ``DataType`` (Registers, Coils, etc.).
 
 The web interface allows the user to (online / manual)
 
@@ -39,4 +37,4 @@ The REST API allow the test process to be automated
    library/simulator/config
    library/simulator/datastore
    library/simulator/web
-   library/simulator/restapi
+   library/simulator/restapi
\ No newline at end of file