selfpatch · bburda · Feb 1, 2026 · Feb 1, 2026 · Feb 1, 2026 · Feb 1, 2026
diff --git a/docs/_static/images/00_ui_view.png b/docs/_static/images/00_ui_view.png
diff --git a/docs/_static/images/01a_connection_dialog.png b/docs/_static/images/01a_connection_dialog.png
diff --git a/docs/_static/images/01b_connection_dialog_filled.png b/docs/_static/images/01b_connection_dialog_filled.png
diff --git a/docs/_static/images/02_entity_tree_collapsed.png b/docs/_static/images/02_entity_tree_collapsed.png
diff --git a/docs/_static/images/03_entity_tree_expanded.png b/docs/_static/images/03_entity_tree_expanded.png
diff --git a/docs/_static/images/04_app_entity_detail.png b/docs/_static/images/04_app_entity_detail.png
diff --git a/docs/_static/images/05_data_view.png b/docs/_static/images/05_data_view.png
diff --git a/docs/_static/images/06_topic_data_view.png b/docs/_static/images/06_topic_data_view.png
diff --git a/docs/_static/images/07_operations_panel.png b/docs/_static/images/07_operations_panel.png
diff --git a/docs/_static/images/08_operations_execution.png b/docs/_static/images/08_operations_execution.png
diff --git a/docs/_static/images/09_configurations_list.png b/docs/_static/images/09_configurations_list.png
diff --git a/docs/_static/images/10_configuration_edit.png b/docs/_static/images/10_configuration_edit.png
diff --git a/docs/_static/images/12_curl_health.png b/docs/_static/images/12_curl_health.png
diff --git a/docs/_static/images/13_curl_areas_turtlebot3.png b/docs/_static/images/13_curl_areas_turtlebot3.png
diff --git a/docs/_static/images/14_curl_topic_odom.png b/docs/_static/images/14_curl_topic_odom.png
diff --git a/docs/_static/images/15_postman_collection.png b/docs/_static/images/15_postman_collection.png
diff --git a/docs/_static/images/16_turtlebot_gazebo.png b/docs/_static/images/16_turtlebot_gazebo.png
diff --git a/docs/_static/images/17_turtlebot_run_demo_terminal.png b/docs/_static/images/17_turtlebot_run_demo_terminal.png
diff --git a/docs/_static/images/18_faults_injected_dashboard.png b/docs/_static/images/18_faults_injected_dashboard.png
diff --git a/docs/_static/images/19_faults_injected_app_view.png b/docs/_static/images/19_faults_injected_app_view.png
diff --git a/docs/_static/images/20_sensor_demo_run_terminal.png b/docs/_static/images/20_sensor_demo_run_terminal.png
diff --git a/docs/_static/images/21_sensor_demo_ui_view.png b/docs/_static/images/21_sensor_demo_ui_view.png
diff --git a/docs/api/cpp.rst b/docs/api/cpp.rst
@@ -0,0 +1,104 @@
+C++ API Reference
+=================
+
+This section contains the automatically generated API documentation for the ros2_medkit C++ codebase.
+
+.. note::
+
+   This documentation is generated from source code comments using Doxygen and Breathe.
+   Run the "Docs: Build Doxygen" VS Code task or ``doxygen Doxyfile`` in the docs/ directory
+   before building Sphinx locally. In CI, Doxygen XML is generated automatically.
+
+ros2_medkit_gateway
+-------------------
+
+The HTTP/REST gateway that exposes ROS 2 graph via SOVD-compatible API.
+
+Classes
+~~~~~~~
+
+.. doxygenclass:: ros2_medkit_gateway::GatewayNode
+   :members:
+
+.. doxygenclass:: ros2_medkit_gateway::DiscoveryManager
+   :members:
+
+.. doxygenclass:: ros2_medkit_gateway::DataAccessManager
+   :members:
+
+.. doxygenclass:: ros2_medkit_gateway::OperationManager
+   :members:
+
+.. doxygenclass:: ros2_medkit_gateway::ConfigurationManager
+   :members:
+
+Data Models
+~~~~~~~~~~~
+
+.. doxygenstruct:: ros2_medkit_gateway::QosProfile
+   :members:
+
+.. doxygenstruct:: ros2_medkit_gateway::TopicEndpoint
+   :members:
+
+.. doxygenstruct:: ros2_medkit_gateway::TopicConnection
+   :members:
+
+.. doxygenstruct:: ros2_medkit_gateway::Area
+   :members:
+
+.. doxygenstruct:: ros2_medkit_gateway::Component
+   :members:
+
+ros2_medkit_fault_manager
+-------------------------
+
+Central fault storage and management node.
+
+.. doxygenclass:: ros2_medkit_fault_manager::FaultManagerNode
+   :members:
+
+.. doxygenclass:: ros2_medkit_fault_manager::FaultStorage
+   :members:
+
+.. doxygenclass:: ros2_medkit_fault_manager::InMemoryFaultStorage
+   :members:
+
+ros2_medkit_fault_reporter
+--------------------------
+
+Client library for reporting faults to the fault manager.
+
+.. doxygenclass:: ros2_medkit_fault_reporter::FaultReporter
+   :members:
+
+.. doxygenclass:: ros2_medkit_fault_reporter::LocalFilter
+   :members:
+
+ros2_medkit_diagnostic_bridge
+-----------------------------
+
+Bridge node that converts ROS 2 /diagnostics messages to FaultManager faults.
+
+.. doxygenclass:: ros2_medkit_diagnostic_bridge::DiagnosticBridgeNode
+   :members:
+
+ros2_medkit_serialization
+-------------------------
+
+Runtime JSON ↔ ROS 2 message serialization library.
+
+.. doxygenclass:: ros2_medkit_serialization::JsonSerializer
+   :members:
+
+.. doxygenclass:: ros2_medkit_serialization::TypeCache
+   :members:
+
+.. doxygenclass:: ros2_medkit_serialization::SerializationError
+   :members:
+
+.. doxygenclass:: ros2_medkit_serialization::TypeNotFoundError
+   :members:
+
+.. doxygenclass:: ros2_medkit_serialization::JsonConversionError
+   :members:
diff --git a/docs/api/index.rst b/docs/api/index.rst
@@ -1,103 +1,31 @@
-C++ API Reference
-=================
+API Reference
+=============
 
-This section contains the automatically generated API documentation for the ros2_medkit C++ codebase.
+This section contains API documentation for ros2_medkit.
 
-.. note::
+.. toctree::
+   :maxdepth: 2
 
-   This documentation is generated from source code comments using Doxygen and Breathe.
-   The Doxygen XML is generated during the documentation build process.
+   rest
+   messages
+   cpp
 
-ros2_medkit_gateway
--------------------
-
-The HTTP/REST gateway that exposes ROS 2 graph via SOVD-compatible API.
-
-Classes
-~~~~~~~
-
-.. doxygenclass:: ros2_medkit_gateway::GatewayNode
-   :members:
-
-.. doxygenclass:: ros2_medkit_gateway::DiscoveryManager
-   :members:
-
-.. doxygenclass:: ros2_medkit_gateway::DataAccessManager
-   :members:
-
-.. doxygenclass:: ros2_medkit_gateway::OperationManager
-   :members:
-
-.. doxygenclass:: ros2_medkit_gateway::ConfigurationManager
-   :members:
-
-Data Models
-~~~~~~~~~~~
-
-.. doxygenstruct:: ros2_medkit_gateway::QosProfile
-   :members:
-
-.. doxygenstruct:: ros2_medkit_gateway::TopicEndpoint
-   :members:
-
-.. doxygenstruct:: ros2_medkit_gateway::TopicConnection
-   :members:
-
-.. doxygenstruct:: ros2_medkit_gateway::Area
-   :members:
-
-.. doxygenstruct:: ros2_medkit_gateway::Component
-   :members:
-
-ros2_medkit_fault_manager
--------------------------
+REST API
+--------
 
-Central fault storage and management node.
+:doc:`rest`
+   Complete REST API reference with request/response schemas, error codes,
+   and usage examples.
 
-.. doxygenclass:: ros2_medkit_fault_manager::FaultManagerNode
-   :members:
-
-.. doxygenclass:: ros2_medkit_fault_manager::FaultStorage
-   :members:
-
-.. doxygenclass:: ros2_medkit_fault_manager::InMemoryFaultStorage
-   :members:
-
-ros2_medkit_fault_reporter
---------------------------
-
-Client library for reporting faults to the fault manager.
-
-.. doxygenclass:: ros2_medkit_fault_reporter::FaultReporter
-   :members:
-
-.. doxygenclass:: ros2_medkit_fault_reporter::LocalFilter
-   :members:
-
-ros2_medkit_diagnostic_bridge
------------------------------
-
-Bridge node that converts ROS 2 /diagnostics messages to FaultManager faults.
-
-.. doxygenclass:: ros2_medkit_diagnostic_bridge::DiagnosticBridgeNode
-   :members:
-
-ros2_medkit_serialization
--------------------------
-
-Runtime JSON ↔ ROS 2 message serialization library.
-
-.. doxygenclass:: ros2_medkit_serialization::JsonSerializer
-   :members:
-
-.. doxygenclass:: ros2_medkit_serialization::TypeCache
-   :members:
+Message Definitions
+-------------------
 
-.. doxygenclass:: ros2_medkit_serialization::SerializationError
-   :members:
+:doc:`messages`
+   ROS 2 message and service interfaces for fault reporting, querying,
+   and event notifications.
 
-.. doxygenclass:: ros2_medkit_serialization::TypeNotFoundError
-   :members:
+C++ API
+-------
 
-.. doxygenclass:: ros2_medkit_serialization::JsonConversionError
-   :members:
+:doc:`cpp`
+   Doxygen-generated C++ class reference for extending ros2_medkit.