Добавлены комментарии по поведению сервиса Items с локализацией

proto/items/items.proto

@@ -75,16 +75,18 @@ message Item {
 
   // string locale = 18; // DEPRECATED: используется locale_id
 
-  // При создании или обновлении идентификатор локали в котором создается запись, опционально.
+  // Идентификатор локали полученной записи.
+  // При создании или обновлении идентификатор локали, в которой создается запись, опционально.
   // Если указан, то создается перевод для указанного языка, поле translations игнорируется
-  string locale_id = 100; // идентификатор локали полученной записи
+  string locale_id = 100;
 
   // Позволяет одновременно установить/получить несколько переводов и производить манипуляции с переводами
   // Ключами является идентификатор локали, значениями - данные переводы
   map<string, google.protobuf.Struct> translations = 12;
 
-  // список идентификаторов локалей для которых есть переводы
-  // соотвествует ключам в translations
+  // Список идентификаторов локалей, для которых есть переводы
+  // Соотвествует списку переводов в translations, при получении записи всегда возвращается
+  // полный список. Невозможно обновить вручную: формируется системой
   repeated string translations_ids = 101;
 }
 
@@ -144,7 +146,10 @@ message FindOptions {
   bool hidden = 5;
   bool templates = 6;
   string locale_id = 7; // Язык перевода который будет использоваться. Если не указан, то возвращаются данные для языка по умолчанию
-  repeated string translations_ids = 8; // Список идентификаторов переводов/локалей, которых должны быть включены в результат
+
+  // Список идентификаторов переводов/локалей, которых должны быть включены в результат
+  // Возможно указание '*' для получения всех переводов
+  repeated string translations_ids = 8;
 }
 
 message UpdateOptions {
@@ -153,7 +158,10 @@ message UpdateOptions {
 
 message GetPublishedOptions {
   string locale_id = 7; // Язык перевода который будет использоваться. Если не указан, то возвращаются данные для языка по умолчанию
-  repeated string translations_ids = 8; // Список идентификаторов переводов/локалей, которых должны быть включены в результат
+
+  // Список идентификаторов переводов/локалей, которых должны быть включены в результат
+  // Возможно указание '*' для получения всех переводов
+  repeated string translations_ids = 8;
 }
 
 message DeleteOptions {
@@ -180,7 +188,10 @@ message FindPublishedOptions {
   bool hidden = 5;
   bool templates = 6;
   string locale_id = 7; // Язык перевода который будет использоваться. Если не указан, то возвращаются данные для языка по умолчанию
-  repeated string translations_ids = 8; // Список идентификаторов переводов/локалей, которых должны быть включены в результат
+
+  // Список идентификаторов переводов/локалей, которых должны быть включены в результат
+  // Возможно указание '*' для получения всех переводов
+  repeated string translations_ids = 8;
 }
 
 message FindArchivedOptions {