Apply code review suggestions

src/internal/Классы/АннотацияБлестяшка.os

@@ -1,5 +1,5 @@
 // Маркерная аннотация для указания, что прилепляемая частица
-// является произвольным значением, передавамым кодом.
+// является произвольным значением, передаваемым в конструктор желудя.
 //
 // Может быть использована только над параметром конструктора/метода завязи желудя.
 //

src/internal/Классы/АннотацияВерховный.os

@@ -2,7 +2,7 @@
 // В случае конфликта имен при получении желудей или их регистрации, будет использован желудь с аннотацией `&Верховный`.
 //
 // При наличии нескольких желудей с одним и тем же прозвищем позволяет определить, какой из них следует возвращать
-// при поиске единственного желудя по его прозвищу.
+// при поиске конкретного желудя по его прозвищу.
 //
 // Если несколько желудей с одним и тем же именем/прозвищем имеют аннотацию `&Верховный`, будет вызвано исключение.
 //

src/internal/Классы/АннотацияДуб.os

@@ -2,7 +2,8 @@
 // `&Дуб` сам по себе тоже является желудем, то есть может запрашивать прилепление частиц,
 // является объектом для обработки `&Напильник`ом, может иметь `&Спецификация` и так далее.
 //
-// Дуб содержит методы, помеченные аннотацией `&Завязь`, которые возвращают желуди.
+// Дуб обычно содержит методы, помеченные аннотацией `&Завязь`, которые возвращают желуди, но
+// может содержать и другие методы, не связанные непосредственно с созданием желудей.
 //
 // Размещается над конструктором класса.
 //

src/internal/Классы/АннотацияЗавязь.os

@@ -3,7 +3,8 @@
 // Может иметь параметры, каждый из которых должен быть промаркирован как &Пластилин, &Деталька или &Блестяшка.
 // В указанные параметры автоматически будут прилеплены соответствующие частицы при создании желудя.
 //
-// Размещается над экспортной функцией в классе, проаннотированном как `&Дуб`.
+// Может размещаться над экспортной функцией в классе, проаннотированном как `&Дуб`, или над методом-лямбдой,
+// передаваемой в качестве параметра в `Поделка.ДобавитьЗавязь()`.
 //
 // Параметры:
 //   Значение - Строка - Имя создаваемого желудя. По умолчанию будет использовано имя метода.

src/internal/Классы/АннотацияПластилин.os

@@ -8,8 +8,9 @@
 //   Значение - Строка - Имя прилепляемого желудя. Если не заполнено, используется имя параметра конструктора/поля
 //                       класса или часть имени метода для установки значения.
 //   Тип - Строка - Тип прилепляемого желудя. В случае передачи значения "Желудь", будет внедрен желудь как таковой.
-//                  Так же может быть указан тип "Массив", "ТаблицаЗначений" и другие. Полный список доступных типов
-//                  см. в библиотеке [autumn-collections](https://github.com/autumn-library/autumn-collections).
+//                  Так же может быть указан тип-коллекция: "Массив", "ТаблицаЗначений" и другие. Полный список
+//                  доступных типов см. в библиотеке
+//                  [autumn-collections](https://github.com/autumn-library/autumn-collections).
 //   Блестяшка - Произвольный - Повторяемый параметр. Передаваемые в прилепляемый желудь произвольные значения.
 //
 // Пример:

src/internal/Классы/АннотацияСпецификация.os

@@ -9,14 +9,12 @@
 	Возврат _Значение;
 КонецФункции
 
-// `@unstable`
-//
-// Аннотация для указания жизненого цикла приложения, начиная с которого разрешено создавать желудь.
+// Аннотация для указания жизненного цикла приложения, начиная с которого разрешено создавать желудь.
 //
 // По умолчанию все желуди имеют спецификацию "Выполнение", означающую, что желудь может быть создан только после вызова
 // `Поделка.ЗапуститьПриложение()`.
 //
-// К желудям со специкацией "Инициализация" не применяются напильники.
+// К желудям со спецификацией "Инициализация" не применяются напильники.
 //
 // Размещается над конструктором класса или над методом `&Завязи`.
 //

src/internal/Классы/АннотацияТабакерка.os

@@ -1,5 +1,5 @@
 // Пометка, что прилепляемая частица прилепляется не непосредственно, а через специальный объект
-// типа `Табакерка`, который позволяет получить частицу программно.
+// типа `Табакерка`, который позволяет получить частицу программно и отложенно.
 //
 // Может использоваться для внедрения компанейских желудей, внедрения желудя самого в себя, 
 // для разрыва циклических зависимостей, для передачи дополнительных параметров прилепляемого желудя и т.п.