#497 closed улучшение (готово)
РЭ: странное расположение описания алгоритма поиска свободного канального окончания
Reported by: | alx | Owned by: | Vladimir |
---|---|---|---|
Priority: | major | Component: | Руководство по эксплуатации |
Keywords: | Cc: |
Description
В РЭ аппаратуры MC04-DSL-3U редакции 38 пункт 7.4.30, в котором описан алгоритм поиска и выбора канального окончания SIP для обслуживания входящего со стороны сети IP вызова почему-то называется "Тип окончания – PRI / Выбор канального окончания при входящем вызове". Это может создать у читателя ошибочное представление о том, что этот алгоритм каким-то образом связан именно с этим типом канальных окончаний (PRI), и не используется в случае окончаний других типов. Предлагаю изменить название этого пункта, убрав из него упоминание типа канального окончания PRI.
Кроме этого, мне кажется нелогичным, что этот общий процесс описан где-то в середине текста РЭ между описаниями работы конкретных типов канальных окончаний. Если предположить, что читатель читает текст последовательно, в том порядке, в каком он написан, получается, что сначала он несколько раз (например на страницах 211, 212, 218) встречает использование неизвестного ему понятия "второй проход поиска", и лишь много позже, прочитав страницу 234, наконец узнает, что существует два прохода поиска, и в чем же они заключаются.
Я считаю, что более логично было бы излагать описание работы платы от общего к частному, то есть сначала описать общие базовые понятия для канальных окончаний, а затем переходить к описанию их отдельных типов.
Также я считаю, что следует сначала давать определение некоему понятию (за исключением общеизвестных), и только потом им оперировать. В крайнем случае, если определить понятие до его первого использования по каким-то причинам невозможно, было бы полезно в месте такого упоминания дать ссылку на место, где оно определено. Например, текст на странице 213 было бы хорошо дополнить следующим образом:
Если вызываемый URI не совпадает с URI канального окончания (вызов принят на втором проходе поиска совпадением имени с регулярным выражением, установленным конфигурационным параметром "Рег. выражение вызова" - см. описание алгоритма поиска канального окончания при входящем вызове на странице 234),...
В РЭ-40 Алгоритм поиска канального окончания при входящем вызове
вынесен отдельным пунктом 7.1.2 (стр.194) в самом начале раздела:
"7 УПРАВЛЕНИЕ ГОЛОСОВЫМ ШЛЮЗОМ VE-01/ VE-02
7.1 Общая информация
"