Opened 4 years ago

Closed 4 years ago

Last modified 15 months ago

#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),...

Change History (2)

comment:1 by Vladimir, 4 years ago

Resolution: готово
Status: newclosed

В РЭ-40 Алгоритм поиска канального окончания при входящем вызове
вынесен отдельным пунктом 7.1.2 (стр.194) в самом начале раздела:
"7 УПРАВЛЕНИЕ ГОЛОСОВЫМ ШЛЮЗОМ VE-01/ VE-02
7.1 Общая информация
"

comment:2 by san, 15 months ago

milestone: 1 очередь

Milestone deleted

Note: See TracTickets for help on using tickets.