add missing comments

Author: alessio-perugini

rpc/cc/arduino/cli/commands/v1/commands.pb.go

@@ -179,6 +179,7 @@ service ArduinoCoreService {
   // Read the settings from a YAML file
   rpc ConfigurationOpen(ConfigurationOpenRequest) returns (ConfigurationOpenResponse);
 
+  // Get the current configuration
   rpc ConfigurationGet(ConfigurationGetRequest) returns (ConfigurationGetResponse);
 
   // Enumerate all the keys/values pairs available in the configuration
@@ -215,13 +216,16 @@ message InitResponse {
     TaskProgress task_progress = 2;
   }
   oneof message {
+    // The progress
     Progress init_progress = 1;
+    // The error in case the instance initialization failed.
     google.rpc.Status error = 2;
     // Selected profile information
     SketchProfile profile = 3;
   }
 }
 
+// Represent the reason why an instance initialization failed.
 enum FailedInstanceInitReason {
   // FAILED_INSTANCE_INIT_REASON_UNSPECIFIED the error reason is not specialized
   FAILED_INSTANCE_INIT_REASON_UNSPECIFIED = 0;
@@ -297,6 +301,7 @@ message UpdateLibrariesIndexResponse {
 }
 
 message IndexUpdateReport {
+  // The status of the index update
   enum Status {
     // The status of the index update is unspecified.
     STATUS_UNSPECIFIED = 0;

rpc/cc/arduino/cli/commands/v1/commands.proto

@@ -27,8 +27,11 @@ message Instance {
 
 message DownloadProgress {
   oneof message {
+    // Start of the download.
     DownloadProgressStart start = 1;
+    // Update of the download.
     DownloadProgressUpdate update = 2;
+    // End of the download.
     DownloadProgressEnd end = 3;
   }
 }
@@ -214,7 +217,9 @@ message MonitorPortConfiguration {
 }
 
 message MonitorPortSetting {
+  // The setting id
   string setting_id = 1;
+  // The setting value
   string value = 2;
 }
 

rpc/cc/arduino/cli/commands/v1/commands_grpc.pb.go

@@ -133,8 +133,11 @@ message BuilderResult {
 }
 
 message ExecutableSectionSize {
+  // The name of the executable section
   string name = 1;
+  // The executable size
   int64 size = 2;
+  // The exectuable maximum size
   int64 max_size = 3;
 }
 

rpc/cc/arduino/cli/commands/v1/common.pb.go

@@ -61,6 +61,7 @@ message PlatformLoadingError {}
 message PlatformDownloadRequest {
   // Arduino Core Service instance from the `Init` response.
   Instance instance = 1;
+  // Vendor name of the platform (e.g., `arduino`).
   string platform_package = 2;
   // Architecture name of the platform (e.g., `avr`).
   string architecture = 3;