Enhance documentation as per issue #250

osi_featuredata.proto

@@ -225,6 +225,10 @@ message RadarDetection
     // indicated by an identical ambiguity ID.
     //
     // \note Unambiguous measurements have the ambiguity ID 0.
+    // \note Multiple seperate detections from e.g. a large object do not
+    // on their own necessarily create any ambiguity, i.e. they do not
+    // usually share an an ambiguity ID.  They can however be ambiguous
+    // with other detections.
     //
     optional Identifier ambiguity_id = 10;
 

osi_sensorviewconfiguration.proto

@@ -410,8 +410,8 @@ message RadarSensorViewConfiguration
         // Unit: [rad]
         optional double vertical_angle = 2;
 
-        // Combined response of emitter and receiver antenna at this
-        // point (positive dB is gain, negative dB is attenuation).
+        // Response of antenna at this point (positive dB is gain,
+        // negative dB is attenuation).
         //
         // Unit: [dB]
         optional double response = 3;