Documentation modifications

adas-core.Application/Services/ObservationDemoService.cs

@@ -8,6 +8,13 @@ using adas_core.Domain.Utils;
 
 namespace adas_core.Application.Services;
 
+/// <summary>
+/// Provides a demo implementation of <see cref="IObservationDemoService"/> that coordinates observation handling using <see cref="IConfigObservationService"/> for configuration and a <see cref="Lazy{T}"/> of <see cref="IAlarmService"/> for deferred alarm access.
+/// </summary>
+/// <remarks>
+/// The service is constructed with an <see cref="IConfigObservationService"/> for observation configuration and a lazily-initialized <see cref="IAlarmService"/> so that alarm functionality is created only on first use.
+/// </remarks>
+/// <!-- aidoc:v1 sig=fc27ac9 -->
 public class ObservationDemoService(
     IConfigObservationService configObservationService,
     Lazy<IAlarmService> alarmService)