Обновлены комментарии в классах Catalog и CodeSeries для улучшения понимания свойств checkUnique и codeSeries. Добавлены пояснения о значении и области действия уникальности кода справочника.

Author: johnnyshut

src/main/java/com/github/_1c_syntax/bsl/mdo/Catalog.java

@@ -116,13 +116,19 @@ public class Catalog implements ReferenceObject, AccessRightsOwner {
   List<MdoReference> owners;
 
   /**
-   * Проверять уникальность кода справочника
+   * Проверять уникальность кода справочника.
+   * Определяет, нужно ли проверять уникальность кода справочника.
+   * Если значение равно true, то код справочника должен быть уникальным в пределах области,
+   * определяемой свойством {@link #codeSeries}.
    */
   @Default
   boolean checkUnique = true;
 
   /**
-   * Серия кодов справочника
+   * Серия кодов справочника.
+   * Определяет область действия уникальности кода справочника.
+   * Значение по умолчанию: {@link CodeSeries#WHOLE_CATALOG}.
+   * Для формата EDT: если поле отсутствует, автоматически устанавливается значение WHOLE_CATALOG.
    */
   @Default
   CodeSeries codeSeries = CodeSeries.WHOLE_CATALOG;

src/main/java/com/github/_1c_syntax/bsl/mdo/support/CodeSeries.java

@@ -32,26 +32,46 @@
 import lombok.experimental.Accessors;
 
 /**
- * Серия кодов справочника
+ * Серия кодов справочника.
+ * Определяет область действия уникальности кода справочника.
  */
 @ToString(of = "fullName")
 public enum CodeSeries implements EnumWithName {
+  /**
+   * Весь справочник - уникальность кода проверяется во всем справочнике
+   */
   WHOLE_CATALOG("WholeCatalog", "ВесьСправочник"),
+  /**
+   * В пределах подчинения - уникальность кода проверяется в пределах подчинения
+   */
   WITHIN_SUBORDINATION("WithinSubordination", "ВПределахПодчинения"),
+  /**
+   * В пределах подчинения владельцу - уникальность кода проверяется в пределах подчинения владельцу
+   */
   WITHIN_OWNER_SUBORDINATION("WithinOwnerSubordination", "ВПределахПодчиненияВладельцу");
 
   private static final Map<String, CodeSeries> KEYS = EnumWithName.computeKeys(values());
 
+  /**
+   * Полное имя элемента перечисления (на русском и английском языках)
+   */
   @Getter
   @Accessors(fluent = true)
   private final MultiName fullName;
 
+  /**
+   * Конструктор элемента перечисления
+   *
+   * @param nameEn Английское имя элемента
+   * @param nameRu Русское имя элемента
+   */
   CodeSeries(String nameEn, String nameRu) {
     this.fullName = MultiName.create(nameEn, nameRu);
   }
 
   /**
-   * Ищет элемент перечисления по именам (рус, анг)
+   * Ищет элемент перечисления по именам (рус, анг).
+   * Поиск выполняется без учета регистра.
    *
    * @param string Имя искомого элемента
    * @return Найденное значение, если не найден - то WHOLE_CATALOG