#765 closed улучшение (готово)
РЭ: странное расположение разделов описания канальных окончаний 1IND и МБ плат VE-01/VE-02
Reported by: | alx | Owned by: | Vladimir |
---|---|---|---|
Priority: | major | Component: | Руководство по эксплуатации |
Keywords: | Cc: |
Description
В РЭ аппаратуры MC04-DSL-3U редакции 47 описание канального окончания 1IND плат VE-01/VE-02 размещено в тексте РЭ довольно странным образом. Сейчас попробую сформулировать почему.
Мне кажется, что при размещении материала полезно по возможности следовать нескольким принципам:
- связанные логически части (разделы) размещать вместе (рядом друг с другом);
- вести повествование от общего к частному, от простого к сложному;
- описание какого-либо процесса давать в том порядке, в каком этот процесс обычно происходит, то есть от начала к концу;
- сначала давать определение объекту/явлению (например при первом его упоминании), а потом оперировать им;
- при описании однотипных объектов/явлений придерживаться однотипной (единообразной) схемы изложения...
В редакции 47 в описании канального окончания 1IND эти принципы почему-то оказались нарушены (ранее, например, в редакции 45 они более-менее выполнялись). Таким образом, как мне кажется, что новая структура изложения хуже той, которая была раньше.
Канальное окончание 1IND обслуживает телефонные вызовы (звонки) между сетями TDM и IP. Телефонный вызов, как правило, состоит из следующих основных этапов:
- Установка соединения;
- Разговор участников;
- Отбой.
Этапы эти следуют именно в таком порядке. В свою очередь, установка соединения возможна либо в направлении из сети TDM в сеть IP, либо из сети IP в сеть TDM.
Вызов в направлении из TDM в IP в тексте РЭ описан более-менее логично: сначала базовый сценарий (самый простой случай), затем случаи посложнее (междугородный вызов, вызов с early-media), затем вызовы с АОН (еще более сложные). Вызовы с АОН зачем-то выделены в отдельный раздел, но, тем не менее, логика изложения сохранена.
Само собой напрашивалось изложить вызов в направлении из IP в TDM пример но по той же схеме, и так и было в более ранних редакциях, однако в редакции 47 раздел "Вызов со стороны IP" зачем-то перенесен вниз по тексту. В результате нарушились все перечисленные выше принципы:
- между разделами 7.4.27 и 7.4.35, описывающими установку соединения канальным окончанием 1IND, расположились разделы, описывающие канальные окончания PRI и R2, одновременно раздел 7.4.35, не имеющий никакого отношения к канальному окончанию R2, размещен между разделами, описывающими обслуживание входящих и исходящих вызовов канального окончания R2. Это создает неудобства для читателя при изучении как канального окончания 1IND, так и канального окончания R2.
- На странице 262 описывается вызов IP --> TDM с определением номера, а на странице 273 - тот же вызов, но без определения номера, то есть более простой. Нелогично...
- И на странице 263, и на странице 273 упоминается передача канальным окончанием номера вызываемого абонента ("набор номера"). Но подробное описание того, как именно происходит этот набор номера, находится на странице 273.
- Раздел 7.4.29 описывает отбой соединения, а раздел 7.4.35 - установку соединения, что нарушает порядок естественного хода событий.
Сказанное выше справедливо также в отношении описания канального окончания MB и R2DTMF, которые аналогичным образом "переплетены" друг с другом. Стой лишь разницей, что так было и в более старых редакциях.
В дополнение ко всему два разных раздела (7.4.26 и 7.4.27) имеют совершенно одинаковое название, что вызывает недоумении уже при чтении оглавления (тем более что теперь они располагаются рядом).
Предлагаю:
- Вернуть порядок расположения разделов, описывающих канальное окончание 1IND к состоянию, которое было в РЭ редакции 45.
- Изменить названия разделов 7.4.26 и 7.4.27 так, чтобы они отражали, что первый касается входящих вызовов (TDM --> IP), а второй - исходящих (IP --> TDM).
- Перенести раздел 7.4.43, разместив его между разделами 7.4.56 и 7.4.57.
Change History (5)
comment:1 by , 4 years ago
follow-up: 3 comment:2 by , 3 years ago
Replying to alx:
Предлагаю:
- Изменить названия разделов 7.4.26 и 7.4.27 так, чтобы они отражали, что первый касается входящих вызовов (TDM --> IP), а второй - исходящих (IP --> TDM).
Например, так?:
"7.4.26 Тип окончания – 1IND / Определение номера входящего вызова TDM --> IP" ?
"7.4.27 Тип окончания – 1IND / Определение номера исходящего вызова IP --> TDM" ?
Или так?:
"7.4.26 Тип окончания – 1IND / Определение номера входящего вызова со стороны TDM" ?
"7.4.27 Тип окончания – 1IND / Определение номера исходящего вызова в сторону TDM" ?
comment:3 by , 3 years ago
Replying to Vladimir:
Например, так?:
"7.4.26 Тип окончания – 1IND / Определение номера входящего вызова TDM --> IP" ?
"7.4.27 Тип окончания – 1IND / Определение номера исходящего вызова IP --> TDM" ?
Или так?:
"7.4.26 Тип окончания – 1IND / Определение номера входящего вызова со стороны TDM" ?
"7.4.27 Тип окончания – 1IND / Определение номера исходящего вызова в сторону TDM" ?
Да, например так.
comment:4 by , 3 years ago
Resolution: | → готово |
---|---|
Status: | new → closed |
Replying to alx:
Предлагаю:
- Вернуть порядок расположения разделов, описывающих канальное окончание 1IND к состоянию, которое было в РЭ редакции 45.
Порядок теперь такой:
7.4.24 Тип окончания – 1IND / Подключение канального окончания 1IND (индуктивный код)
7.4.25 Тип окончания – 1IND / Вызов со стороны TDM 7.4.26 Тип окончания – 1IND / Определение номера входящего вызова TDM ‒> IP
7.4.27 Тип окончания – 1IND / Вызов со стороны IP7.4.28 Тип окончания – 1IND / Определение номера исходящего вызова IP ‒> TDM
7.4.29 Тип окончания – 1IND / Встречное занятие
7.4.30 Тип окончания – 1IND / Отбой
7.4.31 Тип окончания – 1IND / Редактирование канального окончания 1IND
7.4.32 Тип окончания – 1IND / Состояния канального окончания 1IND
- Изменить названия разделов 7.4.26 и 7.4.27 так, чтобы они отражали, что первый касается входящих вызовов (TDM --> IP), а второй - исходящих (IP --> TDM).
Названия разделов теперь такие:
7.4.26 Тип окончания – 1IND / Определение номера входящего вызова TDM ‒> IP
7.4.28 Тип окончания – 1IND / Определение номера исходящего вызова IP ‒> TDM
- Перенести раздел 7.4.43, разместив его между разделами 7.4.56 и 7.4.57.
После переноса теперь так:
7.4.56 Тип окончания – МБ / Прием вызова со стороны сети IP
7.4.57 Тип окончания – МБ / Вызов в сторону сети IP
7.4.58 Тип окончания – МБ / Отбой соединения
"МБ / Прием вызова со стороны сети IP" перенесён из группы ""R2DTMF" в группу "МБ"
Уточню, что описание канального окончания МБ тоже было изложено вполне логично и последовательно в РЭ редакции 42, однако в РЭ редакции 43 раздел "МБ / Прием вызова со стороны сети IP" с непонятной мне целью был размещен между разделами "R2DTMF / Сигналы межрегистровой сигнализации" и "R2DTMF / Входящий вызов". Видимо, кто-то посчитал, что без знания, как вызов принимает окончание МБ, читатель не поймет, как принимается входящий вызов окончанием R2DTMF... :) :)