doc(diagnostics): добавлены разделы исключений для MagicDate и MagicNumber

- Включены новые разделы "Исключения" в документацию для диагностики магических дат и чисел.
- Описаны случаи, когда диагностика не срабатывает, включая присваивание к свойствам структур и вызовы методов.
- Обновлены примеры кода для лучшего понимания исключений.

Author: johnnyshut

docs/diagnostics/MagicDate.md

@@ -2,6 +2,7 @@
 
 <!-- Блоки выше заполняются автоматически, не трогать -->
 ## Описание диагностики
+
 Магическая дата - это любая дата в вашем коде, которая не очевидна без погружения в контекст.
 
 ## Примеры
@@ -12,7 +13,7 @@
 Если текДата < '20151021' Тогда
     ХоверБордБудетИзобретен = Неопределено;
 КонецЕсли;
-``` 
+```
 
 Хорошо
 
@@ -35,3 +36,26 @@
     ХоверБордБудетИзобретен = Неопределено;
 КонецЕсли;
 ```
+
+## Исключения
+
+Диагностика не срабатывает в следующих случаях:
+
+### Присваивание к свойствам структуры
+
+```bsl
+// НЕ срабатывает - осмысленное имя свойства
+СтруктураДанных.ДатаНачала = '20230101';
+СтруктураДанных.ДатаОкончания = '20241231';
+
+// НЕ срабатывает - присваивание к свойству структуры
+НоваяСтруктура = Новый Структура("ДатаСоздания");
+НоваяСтруктура.ДатаСоздания = '20240101';
+```
+
+### Вызовы методов
+
+```bsl
+// НЕ срабатывает - вызов метода
+НоваяСтруктура.Вставить("ДатаСоздания", '20240101');
+```

docs/diagnostics/MagicNumber.md

@@ -15,7 +15,7 @@
     Возврат Длительность < 10 * 60 * 60; 
 
 КонецФункции
-``` 
+```
 
 Хорошо
 
@@ -30,3 +30,27 @@
 
 КонецФункции
 ```
+
+## Исключения
+
+Диагностика не срабатывает в следующих случаях:
+
+### Присваивание к свойствам структуры
+
+```bsl
+// НЕ срабатывает - осмысленное имя свойства
+СтруктураДанных.Код = 100;
+СтруктураДанных.Количество = 5;
+
+// НЕ срабатывает - присваивание к свойству структуры
+НоваяСтруктура = Новый Структура("МояПеременная");
+НоваяСтруктура.МояПеременная = 20;
+```
+
+### Вызовы методов
+
+```bsl
+// НЕ срабатывает - вызов метода
+НоваяСтруктура.Вставить("МояПеременная", 20);
+Массив.Добавить(1);
+```

docs/en/diagnostics/MagicDate.md

@@ -2,6 +2,7 @@
 
 <!-- Блоки выше заполняются автоматически, не трогать -->
 ## Description
+
 Magic date is any date in your code that does not immediately become apparent without being immersed in context.
 
 ## Examples
@@ -35,3 +36,26 @@ If CurrentDate < DateInventionHover() Then
     HoverBoardWillBeInvented = Undefined;
 EndIf;
 ```
+
+## Exceptions
+
+The diagnostic does not trigger in the following cases:
+
+### Structure property assignment
+
+```bsl
+// Does NOT trigger - meaningful property name
+DataStructure.StartDate = '20230101';
+DataStructure.EndDate = '20241231';
+
+// Does NOT trigger - structure property assignment
+NewStructure = New Structure("CreationDate");
+NewStructure.CreationDate = '20240101';
+```
+
+### Method calls
+
+```bsl
+// Does NOT trigger - method call
+NewStructure.Insert("CreationDate", '20240101');
+```

docs/en/diagnostics/MagicNumber.md

@@ -30,3 +30,27 @@ Function GetsTheInterval (Duration in Seconds)
 
 End Function
 ```
+
+## Exceptions
+
+The diagnostic does not trigger in the following cases:
+
+### Structure property assignment
+
+```bsl
+// Does NOT trigger - meaningful property name
+DataStructure.Code = 100;
+DataStructure.Quantity = 5;
+
+// Does NOT trigger - structure property assignment
+NewStructure = New Structure("MyVariable");
+NewStructure.MyVariable = 20;
+```
+
+### Method calls
+
+```bsl
+// Does NOT trigger - method call
+NewStructure.Insert("MyVariable", 20);
+Array.Add(1);
+```