Merge pull request #23 from datatrails/dev/john/8987-swagger-comments

Update description of Confirmation Status

datatrails-common-api/assets/v2/assets/enums.proto

@@ -4,16 +4,12 @@ option go_package="github.com/datatrails/go-datatrails-common-api-gen/assets/v2/
 
 enum ConfirmationStatus {
     CONFIRMATION_STATUS_UNSPECIFIED = 0;
-    PENDING = 1;        // not yet committed
-    CONFIRMED = 2;      // committed. forestrie: "You can easily prove it changed"
-    FAILED = 3;         // permanent failure
-
-	// Regarding the new statuses for forestrie,  See
-	// https://github.com/datatrails/epic-8120-scalable-proof-mechanisms/blob/main/event-trust-levels.md
-    STORED = 4; // forestrie, "its in the db"
-    COMMITTED = 5; // forestrie, "you can know if its changed"
-    // We re-use the constant for CONFIRMED (above)
-    UNEQUIVOCAL = 6; // forestrie, "You easily prove it was publicly available to all" 
+    PENDING = 1;        // Not yet stored
+    CONFIRMED = 2;      // A tree root including the event has been signed by DataTrails
+    FAILED = 3;         // Permanent failure
+    STORED = 4;         // In database, awaiting verifiable commitment
+    COMMITTED = 5;      // The stored event is verifiable
+    UNEQUIVOCAL = 6;    // Provable independent of DataTrails
 }
 
 enum TrackedStatus {