doc: дополнен и уточнен раздел справки "Текучие-(fluent)-утверждения" (…

…vanessa-opensource#796)

* issues vanessa-opensource#784 Отображение пути к загруженным настройкам в браузере тестов

-- Изменена управляемая форма. Добавлен элемент Декорация и группа элементов.
-- Добавлен метод формирования представления пути к файлу настроек, для вывода в
Декорации
-- Событие Нажатие в Декорации связано с командой ЗагрузитьНастройкиИзФайла

* doc: уточнен раздел справки "Текучие-(fluent)-утверждения"

-- добавлено описание метода ВыбрасываетИсключение()
-- уточнен пример запуска "Из кода тестов (TDD)"
-- измен порядок методов публичного api, методы сгруппированы по смыслу
-- исправлена грамматическая ошибка

* doc: Добавлено описание метода Метод
добавлен пример для Метод

doc/xdd/Текучие-(fluent)-утверждения.MD

@@ -4,13 +4,14 @@
 <!-- TOC -->
 
 - [Текучие-(fluent)-утверждения](#текучие-fluent-утверждения)
-    - [Введение](#введение)
-    - [Обращение к плагину (пример)](#обращение-к-плагину-пример)
-        - [Из кода шагов (BDD), запускаемых через `bddRunner`](#из-кода-шагов-bdd-запускаемых-через-bddrunner)
-        - [Из кода тестов (TDD), запускаемых через `xddTestRunner`](#из-кода-тестов-tdd-запускаемых-через-xddtestrunner)
-    - [Публичный интерфейс](#публичный-интерфейс)
-    - [Примеры использования](#примеры-использования)
-        - [Пример немного сложнее](#пример-немного-сложнее)
+  - [Введение](#введение)
+  - [Обращение к плагину (пример)](#обращение-к-плагину-пример)
+    - [Из кода шагов (BDD), запускаемых через `bddRunner`](#из-кода-шагов-bdd-запускаемых-через-bddrunner)
+    - [Из кода тестов (TDD), запускаемых через `xddTestRunner`](#из-кода-тестов-tdd-запускаемых-через-xddtestrunner)
+  - [Публичный интерфейс](#публичный-интерфейс)
+  - [Примеры использования](#примеры-использования)
+    - [Базовый пример](#базовый-пример)
+    - [Пример немного сложнее](#пример-немного-сложнее)
 
 <!-- /TOC -->
 
@@ -50,7 +51,7 @@
 
 Процедура ТестДолжен() Экспорт
   Ожидаем.Что(НекийМассив.Количество(), "Ожидали 9 элементов, но это не так")
-      .ЭтоНе()
+      .Не_()
       .Равно(9);
 КонецПроцедуры
 ```
@@ -66,35 +67,42 @@
 
 - `ЭтоЛожь()` — утверждает, что проверяемое значение является Ложью.
 
+- `ЭтоNull()` — утверждает, что проверяемое значение это Null.
+
+- `ЭтоНеопределено()` — утверждает, что проверяемое значение это Неопределено.
+
 - `Равно(ОжидаемоеЗначение)` — утверждает, что проверяемое значение равно ожидаемому.
 
 - `Больше(МеньшееЗначение)` — утверждает, что проверяемое значение больше, чем переданное в утверждение.
 
+- `Меньше(БольшееЗначение)` — утверждает, что проверяемое значение меньше, чем переданное в утверждение.
+
 - `БольшеИлиРавно(МеньшееИлиРавноеЗначение)` / `Минимум(МинимальноеЗначение)` — утверждает, что проверяемое значение больше или равно переданному в утверждение.
 
 - `МеньшеИлиРавно(БольшееИлиРавноеЗначение)` / `Максимум(МаксимальноеЗначение)` — утверждает, что проверяемое значение меньше или равно переданному в утверждение.
 
-- `Меньше(БольшееЗначение)` — утверждает, что проверяемое значение меньше, чем переданное в утверждение.
+- `Между(НачальноеЗначение, КонечноеЗначение)` — утверждает, что проверяемое значение находится между переданными в утверждение значениями.
 
 - `Заполнено()` — утверждает, что проверяемое значение отличается от значения по умолчанию того же типа.
 
 - `Существует()` — утверждает, что проверяемое значение не Null и не Неопределено.
 
-- `ЭтоНеопределено()` — утверждает, что проверяемое значение это Неопределено.
-
-- `ЭтоNull()` — утверждает, что проверяемое значение это Null.
+- `Содержит(ИскомоеЗначение)` — утверждает, что проверяемое значение содержит переданное в утверждение. Применяется для строк и коллекций.
 
 - `ИмеетТип(Тип)` — утверждает, что проверяемое значение имеет переданный в утверждение тип или имя типа.
 
-- `Между(НачальноеЗначение, КонечноеЗначение)` — утверждает, что проверяемое значение находится между переданными в утверждение значениями.
+- `ИмеетДлину(ОжидаемаяДлина)` — утверждает, что проверяемое значение имеет длину переданную в утверждение. Применяется для строк и коллекций.
 
-- `Содержит(ИскомоеЗначение)` — утверждает, что проверяемое значение содержит переданное в утверждение. Применяется для строк и коллекций.
+- `ВыбрасываетИсключение(ФрагментТекстаИсключения)` — утверждает, что при вызове метода с помощью Метод() платформа формирует исключение с информацией содержащей ФрагментТекстаИсключения (необязательный параметр).
 
-- `ИмеетДлину(ОжидаемаяДлина)` — утверджает, что проверяемое значение имеет длину переданную в утверждение. Применяется для строк и коллекций.
+- `Метод(ИмяМетода, ПараметрыМетода)` - вызывает метод с именем ИмяМетода и параметрами ПараметрыМетода. ПараметрыМетода (необязательный параметр) произвольного типа или массив для передачи нескольких параметров в метод.
 
 <a id="markdown-примеры-использования" name="примеры-использования"></a>
 ## Примеры использования
 
+<a id="markdown-базовый-пример" name="базовый-пример"></a>
+### Базовый пример
+
 ```bsl
 Ожидаем.Что(1 > 0).ЭтоИстина();
 Ожидаем.Что(13 = 2).Не_().ЭтоИстина();
@@ -126,3 +134,13 @@
 		.ИмеетДлину(12)
 		.Не_().Содержит("!!!");
 ```
+
+```bsl
+ПараметрыМетода = Новый Массив();
+ПараметрыМетода.Добавить("ЗначениеПараметра_1");
+ПараметрыМетода.Добавить("ЗначениеПараметра_2");
+
+Ожидаем.Что("Метод МетодСДвумяПараметрами вызывается и не генерирует исключений, но это не так.")
+  .Метод("МетодСДвумяПараметрами", ПараметрыМетода)
+  .Не_().ВыбрасываетИсключение();
+```