Opened 3 years ago

Closed 3 years ago

Last modified 15 months ago

#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. Телефонный вызов, как правило, состоит из следующих основных этапов:

  1. Установка соединения;
  2. Разговор участников;
  3. Отбой.

Этапы эти следуют именно в таком порядке. В свою очередь, установка соединения возможна либо в направлении из сети 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) имеют совершенно одинаковое название, что вызывает недоумении уже при чтении оглавления (тем более что теперь они располагаются рядом).

Предлагаю:

  1. Вернуть порядок расположения разделов, описывающих канальное окончание 1IND к состоянию, которое было в РЭ редакции 45.
  2. Изменить названия разделов 7.4.26 и 7.4.27 так, чтобы они отражали, что первый касается входящих вызовов (TDM --> IP), а второй - исходящих (IP --> TDM).
  3. Перенести раздел 7.4.43, разместив его между разделами 7.4.56 и 7.4.57.

Change History (5)

comment:1 by alx, 3 years ago

Уточню, что описание канального окончания МБ тоже было изложено вполне логично и последовательно в РЭ редакции 42, однако в РЭ редакции 43 раздел "МБ / Прием вызова со стороны сети IP" с непонятной мне целью был размещен между разделами "R2DTMF / Сигналы межрегистровой сигнализации" и "R2DTMF / Входящий вызов". Видимо, кто-то посчитал, что без знания, как вызов принимает окончание МБ, читатель не поймет, как принимается входящий вызов окончанием R2DTMF... :) :)

in reply to:  description ; comment:2 by Vladimir, 3 years ago

Replying to alx:

Предлагаю:

  1. Изменить названия разделов 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" ?

in reply to:  2 comment:3 by alx, 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" ?

Да, например так.

in reply to:  description comment:4 by Vladimir, 3 years ago

Resolution: готово
Status: newclosed

Replying to alx:

Предлагаю:

  1. Вернуть порядок расположения разделов, описывающих канальное окончание 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

  1. Изменить названия разделов 7.4.26 и 7.4.27 так, чтобы они отражали, что первый касается входящих вызовов (TDM --> IP), а второй - исходящих (IP --> TDM).

Названия разделов теперь такие:
7.4.26 Тип окончания – 1IND / Определение номера входящего вызова TDM ‒> IP
7.4.28 Тип окончания – 1IND / Определение номера исходящего вызова IP ‒> TDM

  1. Перенести раздел 7.4.43, разместив его между разделами 7.4.56 и 7.4.57.

После переноса теперь так:
7.4.56 Тип окончания – МБ / Прием вызова со стороны сети IP
7.4.57 Тип окончания – МБ / Вызов в сторону сети IP
7.4.58 Тип окончания – МБ / Отбой соединения

"МБ / Прием вызова со стороны сети IP" перенесён из группы ""R2DTMF" в группу "МБ"

comment:5 by san, 15 months ago

milestone: 1 очередь

Milestone deleted

Note: See TracTickets for help on using tickets.