Update docs

Author: jsurrea

docs/antares-cli.md

@@ -1,15 +1,20 @@
 ---
-title: "🛠️ antares-cli: Command-Line Control"
-description: "Use the antares-cli tool to prototype, command, and collect data from Antares simulations."
+order: 4
+icon: fas fa-terminal
+title: antares-cli
+description: >-
+  A command-line interface for prototyping, commanding, and collecting data from Antares simulations.
 ---
 
 ## 🛠️ antares-cli: Command-Line Control
 
 > **A lightweight interface for controlling Antares simulations via terminal commands.**
+{: .prompt-tip }
 
 `antares-cli` is a powerful tool for prototyping behaviors, capturing telemetry logs, and issuing real-time commands to the Antares simulation system — useful in both development and operational research settings.
 
----
+![CLI Usage](https://raw.githubusercontent.com/TheSoftwareDesignLab/ANTARES/refs/heads/main/docs/assets/antares-cli.png){: width="700" }
+_Subscribing to simulation events and issuing commands via the CLI._
 
 ## ⚙️ Core Capabilities
 
@@ -22,8 +27,6 @@ description: "Use the antares-cli tool to prototype, command, and collect data f
 
 ➡️ Multiple CLI clients can connect concurrently to a central simulation — ideal for distributed experimentation.
 
----
-
 ## 🚧 Usage
 
 Once installed, the `antares-cli` binary is available globally.
@@ -45,13 +48,11 @@ Once installed, the `antares-cli` binary is available globally.
 | `--verbose`   | Enable detailed output                          |
 | `--json`      | Output results in JSON format (structured logs) |
 
----
-
 ## 💡 Example
 
 ```bash
 antares-cli add-ship --type line --x 0 --y 0 --angle 0.5 --speed 5.0
-````
+```
 
 ➡️ This creates a ship moving along a fixed heading at 5 m/s.
 You can then subscribe to track updates and log them using:
@@ -60,8 +61,6 @@ You can then subscribe to track updates and log them using:
 antares-cli subscribe
 ```
 
----
-
 ## 📎 Technical Details
 
 For installation instructions, configuration schema, and developer options, see the [antares-python GitHub repository](https://github.com/jsurrea/antares-python).

docs/antares-python.md

@@ -1,9 +1,9 @@
 ---
 order: 3
-icon: fas fa-terminal
-title: antares-cli
+icon: fas fa-robot
+title: Antares Python Client
 description: >-
-  A command-line interface for prototyping, commanding, and collecting data from Antares simulations.
+  A high-level Python library for integrating Antares simulations into real-time AI, control, and monitoring systems.
 ---
 
 ## 🧠 What is the Antares Python Client?
@@ -12,8 +12,6 @@ The **Antares Python Client** is a high-level, developer-friendly library that a
 
 Whether you're prototyping autonomous decision-making systems, testing radar algorithms, or integrating simulations into command dashboards, `antares-python` makes it possible - and remarkably simple.
 
----
-
 ## ⚙️ Why Python?
 
 Python is the language of choice for:
@@ -25,8 +23,6 @@ Python is the language of choice for:
 
 With `antares-python`, you can embed Rust-powered realistic, high-frequency maritime simulations directly into those environments — enabling closed-loop testing, ML training, or control logic validation at scale.
 
----
-
 ## 📦 Python Integration in 30 Seconds
 
 ```python
@@ -49,8 +45,6 @@ async for track in client.subscribe():
 
 ➡️ *Spawn a ship and react to its telemetry in real time. Combine with tactical logic or AI systems for autonomous decisions.*
 
----
-
 ## 🛰️ Use Cases in Autonomous & Military Systems
 
 Antares Python Client acts as a **simulation substrate** for intelligent systems. Key applications include:
@@ -70,8 +64,6 @@ Antares Python Client acts as a **simulation substrate** for intelligent systems
 * ✅ **System validation under uncertainty**
   Test robustness of autonomous systems against unpredictable scenarios, sensor degradation, or adversarial tactics.
 
----
-
 ## 🌍 Designed for Integration
 
 You can easily:
@@ -83,14 +75,10 @@ You can easily:
 
 Antares Python Client has **zero external dependencies** beyond its own models and tools, ensuring it's lightweight and portable — ideal for secure or isolated environments.
 
----
-
 ## 🛡️ Robust. Modular. Battle-Ready.
 
 Whether you're building mission rehearsal tools, tactical planning apps, or AI-controlled defense simulations — `antares-python` offers a powerful, production-ready foundation for integration, testing, and innovation.
 
----
-
 ## 🔗 Learn More
 
 Full technical details, API reference, and source code are available at the [GitHub repository](https://github.com/TheSoftwareDesignLab/ANTARES/antares-python).

docs/antares-simulator.md

@@ -0,0 +1,68 @@
+---
+order: 1
+icon: fas fa-satellite-dish
+title: Antares Simulator
+mermaid: true
+description: >-
+  A high-fidelity simulation engine for maritime radar and sensor systems, designed for real-time experimentation and analysis.
+---
+
+# 🧠 ANTARES Simulator
+
+> The core of the platform: a high-fidelity, real-time radar simulation engine built for performance, extensibility, and operational realism.  
+{: .prompt-info }
+
+## 🎯 Purpose
+
+The simulator models **naval radar operations** in dynamic maritime scenarios, supporting both training and system integration efforts.  
+It enables reproducible experiments, behavior analysis, and real-time radar tracking.
+
+## 🔄 Architecture Overview
+
+- **Built in Rust**: Ensures high performance, type safety, and memory security.
+- **Command-Driven**: Controlled via TCP messages for full integration flexibility.
+- **Event Loop Core**: Uses a time-stepped loop to simulate real-world radar behavior.
+- **Data Broadcast**: Publishes `Track` objects in real-time to subscribers (via TCP or WebSocket).
+
+```mermaid
+flowchart TD
+    A[Simulation Controller] --> B[World State Engine]
+    B --> C[Ship Dynamics]
+    B --> D[Radar Signal Generator]
+    D --> E[Track Data Stream]
+```
+
+> Track data can be consumed by GUI clients, automated systems, or external C4I modules.
+> {: .prompt-tip }
+
+## 📦 Use Cases
+
+* 🧭 **Officer Training Simulations**
+  Build realistic operational scenarios without physical deployments.
+
+* 🔍 **Sensor Behavior Testing**
+  Validate how detection algorithms react under different vessel configurations.
+
+* 🧪 **System Integration & Interoperability**
+  Emulate radar behavior to test communication with external systems (e.g., CMS, C4I).
+
+* 🧰 **Research and Development**
+  Rapidly prototype and validate new tracking algorithms or radar control strategies.
+
+## 🛠️ Configuration
+
+Simulation parameters are defined via structured TOML or TCP commands.
+Entities are configurable with:
+
+* Initial position, heading, and velocity
+* Radar range, scan rate, and update interval
+* Behavioral strategies and decision logic
+
+> Ships and radars can be added, modified, or removed at runtime.
+> {: .prompt-info }
+
+## Learn More
+
+For source code, contributions, or in-depth technical details, visit the GitHub repository:  
+👉 [https://github.com/TheSoftwareDesignLab/ANTARES/antares](https://github.com/TheSoftwareDesignLab/ANTARES/antares)
+

docs/antares-web.md

@@ -0,0 +1,55 @@
+---
+order: 2
+icon: fas fa-pager
+title: Antares Web Radar
+description: >-
+  A real-time web-based radar visualization and experimentation tool built for rapid prototyping and analysis.
+---
+
+## Overview
+
+**Antares Web Radar** is an interactive, browser-based radar interface designed to **visualize, analyze, and command radar simulations** in real time. Built for defense research, operational testing, and prototyping scenarios, it provides a seamless way to **observe radar data** with minimal setup or installation.
+
+By abstracting complexity and exposing only the necessary controls and data streams, Antares Web Radar empowers engineers, analysts, and decision-makers to **focus on the tactical implications of sensor data**, not the plumbing behind it.
+
+## Key Features
+
+### 🔍 Live Visualization of Radar Tracks
+- Real-time display of **moving targets** and **navigational aids** (ATONs) over a configurable radar canvas.
+- Automatic detection and **consolidation of multiple echoes** for the same object.
+- Intuitive visualization of **range, speed, and bearing** for all tracked entities.
+
+### 🧪 Rapid Experimentation
+- Seamlessly issue **commands to the simulation engine** such as adding vessels or resetting scenarios.
+- Built-in interface for configuring ships with different radar signatures, kinematics, and identifiers.
+- Designed to support **live experiments and training exercises** with minimal latency.
+
+### 🛰️ WebSocket Integration
+- Connects to a live radar stream via WebSocket for **low-latency data ingestion**.
+- Decodes structured telemetry modeled after standard radar output formats (e.g. range, bearing, position, velocity).
+
+### ⚙️ Zero-Install, Full Capability
+- Entirely web-based: just open the browser and connect.
+- Configurable via `.env` settings for controller and radar endpoints.
+- No installation or compilation required—**works out of the box** in any modern web browser.
+
+## Use Cases
+
+- **Sensor behavior validation**: visualize how changes in radar settings or environment affect target tracking.
+- **Command & control prototyping**: simulate real-world scenarios and test control interfaces.
+- **Training support**: provide operators or researchers with an intuitive radar feed for interpretation practice.
+- **Tactical replay and debrief**: re-run scenarios and observe how the system behaved under various configurations.
+
+## Screenshots
+
+![Antares Radar UI](https://raw.githubusercontent.com/TheSoftwareDesignLab/ANTARES/refs/heads/main/docs/assets/antares-radar-ui.png){: width="700" }
+_Live radar display with multiple dynamic targets_
+
+![Ship Configuration Modal](https://raw.githubusercontent.com/TheSoftwareDesignLab/ANTARES/refs/heads/main/docs/assets/antares-ship-config.png){: width="700" }
+_Adding a new vessel with customizable parameters_
+
+## Learn More
+
+For source code, contributions, or in-depth technical details, visit the GitHub repository:  
+👉 [https://github.com/TheSoftwareDesignLab/ANTARES/antares-web](https://github.com/TheSoftwareDesignLab/ANTARES/antares-web)
+