Improve documentation (#208)

- **Make it even more clear that its UTC**
- **Remove strange artefact 'bool' in documentation**

fixes #91

Author: Marenz

proto/frequenz/api/dispatch/v1/dispatch.proto

@@ -203,10 +203,10 @@ message DispatchMetadata {
 
 // Filter parameter for specifying multiple time intervals
 message TimeIntervalFilter {
-  // Filter by time >= this timestamp.
+  // Filter by time >= this UTC timestamp.
   google.protobuf.Timestamp from = 1;
 
-  // Filter by time <= this timestamp.
+  // Filter by time <= this UTC timestamp.
   google.protobuf.Timestamp to = 2;
 }
 
@@ -448,7 +448,7 @@ message RecurrenceRule {
 
   // When this dispatch should end.
   // A dispatch can either recur a fixed number of times, or until a given timestamp.
-  // If this field is not set, the dispatch will recur indefinitely.bool
+  // If this field is not set, the dispatch will recur indefinitely.
   EndCriteria end_criteria = 3;
 
   // On which minute(s) of the hour does the event occur
@@ -597,7 +597,7 @@ message UpdateMicrogridDispatchRequest {
       repeated uint32 bymonths = 8;
     }
 
-    // The start time
+    // The start time in UTC.
     // When updating a dispatch, ensure that the starting timestamp is set to
     // the current time or any future time.
     // Timestamps earlier than the current time are not allowed.