добавлены комментарии

proto/items/items.proto

@@ -123,7 +123,7 @@ message Filter {
 }
 
 message CreateOptions {
-  bool update_attrs = 1;
+  bool update_attrs = 1; // позволяет обновить системные поля: created_by, created_at, created_rev_at, updated_by, updated_at
 }
 
 message FindOptions {
@@ -135,7 +135,7 @@ message FindOptions {
 }
 
 message UpdateOptions {
-  bool update_attrs = 1;
+  bool update_attrs = 1; // позволяет обновить системные поля: created_by, created_at, created_rev_at, updated_by, updated_at
 }
 
 message GetPublishedOptions {
@@ -143,20 +143,20 @@ message GetPublishedOptions {
 }
 
 message DeleteOptions {
-  bool update_attrs = 1;
-  bool erase = 2;
+  bool update_attrs = 1; // позволяет обновить системные поля: created_by, created_at, created_rev_at, updated_by, updated_at
+  bool erase = 2; // полное удаление без сохранения удаленной версии объекта
 }
 
 message UndeleteOptions {
-  bool update_attrs = 1;
+  bool update_attrs = 1; // позволяет обновить системные поля: created_by, created_at, created_rev_at, updated_by, updated_at
 }
 
 message PublishOptions {
-  bool update_attrs = 1;
+  bool update_attrs = 1; // позволяет обновить системные поля: created_by, created_at, created_rev_at, updated_by, updated_at
 }
 
 message UnpublishOptions {
-  bool update_attrs = 1;
+  bool update_attrs = 1; // позволяет обновить системные поля: created_by, created_at, created_rev_at, updated_by, updated_at
 }
 
 message FindPublishedOptions {
@@ -239,7 +239,7 @@ message UpdateRequest {
 }
 
 message DeleteRequest {
-  Item item = 1;
+  Item item = 1; // важны только переданные внутри идентификаторы или, если указана опция update_attrs, поля которые изменяются: created_by, created_at, created_rev_at, updated_by, updated_at
   DeleteOptions options = 2;
 }