Opened 3 years ago

Closed 3 years ago

Last modified 15 months ago

#786 closed улучшение (готово)

РЭ: неполнота/непоследовательность в изложении материала

Reported by: alx Owned by: Vladimir
Priority: minor Component: Руководство по эксплуатации
Keywords: Cc:

Description

В РЭ аппаратуры MC04-DSL-3U редакции 48 в п. 7.1 на странице 212 написано перечисляется краткое назначение нескольких из имеющихся в диалоге фонйигурации плат VE-01/VE-02 вкладок (см. #785), один абзац на одну вкладку. Однако посреди них (между назначением вкладки "Канальные окончания" и назначением вкладки "SIP пользователи") неожиданно вклинился абзац, сообщающий читателю о том, что надо сделать для организации полупостоянных потоков RTP.

Такое изложение мне кажется нелогичным и непоследовательным сразу по нескольким причинам:

  1. Изложение одной темы "разорвано" из-за того, что в него "вклинился" фрагмент другой темы (описывается назначение вкладок веб-интерфейса, затем переход описанию к создания окончаний RTP, затем возврат к описанию назначений вкладок веб-интерфейса). Считаю, что читателю было бы легче воспринимать материал, если бы каждая тема излагалась последовательно и целиком: сначала описать краткое назначение каждой вкладки, а затем описывать действия по организации окончаний RTP.
  1. У плат VE-01/VE-02 более десятка различных типов канальных окончаний. Однако по непонятной причине здесь описана организация лишь одного из них. Я нахожу это непоследовательным и нелогичным. Мне кажется, у любого читателя возникнет вопрос: "А как же организация всех остальных типов канальных окончаний? Мне об этом предлагается догадаться самому?". Я думаю, что следует либо указать здесь действия по организации каждого из имеющихся типов канальных окончаний, либо не указывать их ни для какого.

В свете написанного выше прелагаю:

  1. перенести описание действий по организации окончаний RTP вниз по тексту, разместив его после описания краткого назначения вкладок веб-интерфейса;
  2. либо дополнить описание действий по организации окончаний RTP описанием описание действий по организации канальных окончаний всех остальных типов, либо удалить написанное здесь описание действий по организации окончаний RTP.

Change History (3)

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

Resolution: готово
Status: newclosed

Replying to alx:

В свете написанного выше прелагаю:

  1. перенести описание действий по организации окончаний RTP вниз по тексту, разместив его после описания краткого назначения вкладок веб-интерфейса;
  2. либо дополнить описание действий по организации окончаний RTP описанием описание действий по организации канальных окончаний всех остальных типов, либо удалить написанное здесь описание действий по организации окончаний RTP.

Выбрал п.1, как наиболее простой для реализации в РЭ

Теперь в РЭ-49 будет так:

Вкладка SIP пользователи – для авторизации клиентов сервера регистрации (см. п.7.6).
Вкладка IPoTDM – для настройки передачи IP-пакетов через канал 64 кбит/с (см. п.7.5).
Вкладка Маршруты SIP – для для настройки маршрутизации SIP (см. п.7.7)
Вкладка Группы вызова – для настройки параллельных (групповых) вызовов (см. п. 7.8).
Вкладка ДВО – для настройки дополнительных видов обслуживания (см. п.7.9)

Для организации полупостоянных потоков RTP с использованием или без использования сигнализации откройте вкладку "Канальные окончания" (см. Рис. 7.11 в п.7.4) и выполните действия по п.7.4.63.

in reply to:  1 comment:2 by alx, 3 years ago

Replying to Vladimir:

Выбрал п.1, как наиболее простой для реализации в РЭ

8-()

Почему "выбрал"?

В описании тикета мной было указано на две разные проблемы, одновременно присутствующие в п. 7.1:

  1. непоследовательность изложения - изоржение одной темы разрывается абзацем на другую тему;
  2. неполнота изложения - описаны действия по организации лишь одного из более чем десятка имеющихся типов канальных окончаний.

Соответственно, я предложил варианты решения для каждой из этих двух проблем: предложение, обозначенное цифрой "1" касалось решения проблемы, описанной под цифрой "1", а предложение, обозначенное цифрой "2" касалось решения проблемы, описанной под цифрой "2". Я предполагал, что ты устранишь обе эти проблемы, а не одну любую из перечисленных на выбор... :)

Выбор в моем предложении, действительно, предлагался, он он состоял не в том, какую из обнаруженных проблем устранить, а в том, каким путем устранить вторую проблему. В предложении, обозначенном цифрой "2", была альтернатива: либо дополнить описание действий по организации окончаний RTP описанием описание действий по организации канальных окончаний всех остальных типов, либо удалить написанное здесь описание действий по организации окончаний RTP.

Я, наверное, отчасти сам виноват, так как поленился писать два отдельных тикета, и создал один тикет на две проблемы. Исправляюсь. Создал новый тикет #804.

comment:3 by san, 15 months ago

milestone: 1 очередь

Milestone deleted

Note: See TracTickets for help on using tickets.