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

[alx]

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

Я нахожу это нелогичным. Мне кажется, у любого читателя возникнет вопрос: "А как же организация всех остальных типов канальных окончаний? Мне об этом предлагается догадаться самому?". Я думаю, чтобы изложение было логичным, следует либо указать здесь действия по организации каждого из имеющихся типов канальных окончаний, либо не указывать действий ни для какого из них.

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

Данная проблема была изложена в тикете #786, но, к сожалению, в его описании я пожаловался сразу на две разные проблемы. Тикет #786 был закрыт после устранения одной из упомянутых в нем проблем, данная же проблема осталась не устраненной.

[Vladimir]

Replying to alx:

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

Если ты, как Автор VE, считаешь, что можно и даже нужно удалить в п.7.1 абзац:
"Для организации полупостоянных потоков RTP с использованием или без использования сигнализации откройте вкладку "Канальные окончания" (см. Рис. 7.11 в п.7.4) и выполните действия по п.7.4.63.", то я его удалю, т.к. для остальных КО я не смогу написать множество пунктов типа "7.4.63 Тип окончания – RTP / Полупостоянные потоки RTP", то я удалю эти 3 строчки в п.7.1.
Если кто-то сможет написать черновики подобных пунктов, то я отредактирую и вставлю.

[Vladimir]

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

[alx]

Replying to Vladimir:

Если ты, как Автор VE, считаешь, что можно

Я как разработчик плат SW-01, VE-01, SWI-CPU, SWI-F и других в вопросах написания РЭ доверяю разработчику РЭ. И если на странице 212 РЭ не описаны действия по созданию, например, канального окончания 1IND, значит разработчик посчитал это возможным, а у меня нет оснований в этом сомневаться.

Однако остается непонятным, почему, тем не менее, действия по созданию канального окончания RTP описаны, хотя они ничем не отличаются от действий по созданию канального окончания 1IND...

и даже нужно удалить в п.7.1 абзац:

...

то я удалю эти 3 строчки в п.7.1.

Я не считаю, что процитированный абзац надо удалить. В описании тикета я предложил на выбор два альтернативных решения:

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

Если кто-то сможет написать черновики подобных пунктов, то я отредактирую и вставлю.

Я могу.

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

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

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

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

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

"Для организации канальных окончаний R2 DTMF откройте вкладку "Канальные окончания" (см. Рис. 7.11 в п.7.4) и выполните действия по п.7.4.40." (хотя в пункте "7.4.40 Тип окончания – R2DTMF / Подключение к шлюзу канального окончания" подключение к шлюзу канального окончания R2DTMF почему-то не описано - см. #844)...

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

"Для организации канальных окончаний АДАСЭ откройте вкладку "Канальные окончания" (см. Рис. 7.11 в п.7.4) и выполните действия по п.7.4.48." (хотя в пункте "7.4.48 Тип окончания – АДАСЭ / Подключение к шлюзу канального окончания" подключение к шлюзу канального окончания АДАСЭ почему-то не описано - см. #845)...

"Для организации канальных окончаний МБ откройте вкладку "Канальные окончания" (см. Рис. 7.11 в п.7.4) и выполните действия по п.7.4.55." (хотя в пункте "7.4.55 Тип окончания – МБ / Подключение к шлюзу канального окончания" подключение к шлюзу канального окончания МБ почему-то не описано - см. #846)...

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

[Vladimir]

Replying to alx:

Replying to Vladimir:

Однако остается непонятным, почему, тем не менее, действия по созданию канального окончания RTP описаны, хотя они ничем не отличаются от действий по созданию канального окончания 1IND...

то я удалю эти 3 строчки в п.7.1.

Я не считаю, что процитированный абзац надо удалить. В описании тикета я предложил на выбор два альтернативных решения:

1. дополнить описание действий по организации окончаний RTP описанием описание действий по организации канальных окончаний всех остальных типов;

2. удалить написанное здесь описание действий по организации окончаний RTP.

Из этих двух "альтернативных" (т.е. допустимых) вариантов я и выбрал самый простой,
т.е. в РЭ-50 удалил "написанное здесь описание действий по организации окончаний RTP.",
т.е. выполнил твою рекомендацию: в РЭ-50 про "организацию полупостоянных потоков RTP"
напечатано только в пункте "7.4.63 Тип окончания – RTP / Полупостоянные потоки RTP"

Если кто-то сможет написать черновики подобных пунктов, то я отредактирую и вставлю.

Я могу.

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

..........................

Мне помнится, что САН был против 10-кратного повторения, по сути дела, одного и того же,
однако, в РЭ-50 (см. на сайте) все подключения для всех КО, вроде как, прописаны.
Что ещё надо исправить по сравнению с действующим РЭ-50 ?

[alx]

Replying to Vladimir:

однако, в РЭ-50 (см. на сайте) все подключения для всех КО, вроде как, прописаны.

А мой comment:3 дальше середины ты не осилил? :) Потому что там я написал, что это не так.

Что ещё надо исправить по сравнению с действующим РЭ-50 ?

Что еще надо исправить, написано в тикетах. :)

[Vladimir]

Replying to alx:

Replying to Vladimir:

однако, в РЭ-50 (см. на сайте) все подключения для всех КО, вроде как, прописаны.

А мой comment:3 дальше середины ты не осилил? :) Потому что там я написал, что это не так.

Так ты считаешь, что текст в п.7.1 из РЭ-48 надо вернуть в РЭ-51 ?:

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

Что ещё надо исправить по сравнению с действующим РЭ-50 ?

Что еще надо исправить, написано в тикетах. :)

Но меня интересует только то, что касается и необходимо для закрытия ЭТОГО тикета,
а не сотни других тикетов, которые будут закрыты позже...

[alx]

Replying to Vladimir:

Так ты считаешь, что текст в п.7.1 из РЭ-48 надо вернуть в РЭ-51 ?:

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

Не считаю.

Но меня интересует только то, что касается и необходимо для закрытия ЭТОГО тикета,

У меня сейчас мозг взорвется! :) Этот тикет ты закрыл 5 недель назад, 1 июля этого года! Для его закрытия уже ничего делать не надо, так как он уже закрыт!

[Vladimir]

Replying to alx:

Replying to Vladimir:

Так ты считаешь, что текст в п.7.1 из РЭ-48 надо вернуть в РЭ-51 ?:

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

Не считаю.

Но меня интересует только то, что касается и необходимо для закрытия ЭТОГО тикета,

У меня сейчас мозг взорвется! :) Этот тикет ты закрыл 5 недель назад, 1 июля этого года! Для его закрытия уже ничего делать не надо, так как он уже закрыт!

Но ты же сам в Комм-3 возобновил дебаты, а то, что он закрыт, совсем не значит,
что текст в РЭ по ЭТОМУ тикету нельзя изменять, а на мой взгляд, можно и нужно,
даже если тикет закрыт, а новый не создан :-)

В комменте-5 ты написал:
"А мой comment:3 дальше середины ты не осилил? :) Потому что там я написал, что это не так.", а что конкретно "не так" - что надо исправить?
Я же уже сообщал, что на мой взгляд
"в РЭ-50 все подключения для всех КО, вроде как, прописаны."

[alx]

Replying to Vladimir:

Но ты же сам в Комм-3 возобновил дебаты,

Ничего не понимаю... Какие дебаты я возобновил? Где они проходили? :) Мой comment:3 был первым моим комментарием в данном тикете...

Мой comment:3 был ответом на твой comment:1, в котором, ты, как мне показалось, неверно интерпретировал мысли, которые я изложил в описании тикета (приписал мне мнение, что нужно удалить фрагмент пункта 7.1). Я постарался пояснить свое мнение подробнее.

Также я попытался "поработать телепатом" и почитать между строк, :) предположив, что твоя фраза "Если кто-то сможет написать черновики подобных пунктов, то я отредактирую и вставлю", хоть и не содержит в себе ни вопроса, ни просьбы, на самом деле была намеком на вопрос "Может ли кто-то написать черновики подобных пунктов?" и на просьбу "Если да, то напишите". Если я не угадал, и таких вопроса и просьбы между строк у тебя спрятано не было, то просто не обращай внимания на написанное в comment:3 начиная с "Я могу...".

Но даже если я своим комментарием, как ты выразился, возобновил дебаты (сам не знаю о чем), какое это имеет отношение к твоему вопросу о закрытии уже закрытого тикета?

а то, что он закрыт, совсем не значит,
что текст в РЭ по ЭТОМУ тикету нельзя изменять,

А разве я утверждал, что текст в РЭ по ЭТОМУ тикету нельзя изменять?

а на мой взгляд, можно и нужно,
даже если тикет закрыт, а новый не создан :-)

Разработчик РЭ - ты. У тебя есть все права и возможности изменить в РЭ все, что считаешь нужным.

В комменте-5 ты написал:
"А мой comment:3 дальше середины ты не осилил? :) Потому что там я написал, что это не так.", а что конкретно "не так"

Не так то, что твое утверждение о том, что в РЭ-50 все подключения для всех КО прописаны, вроде как, не соответствует действительности.

• что надо исправить?

Что надо исправить, написано в описаниях соответствующих тикетов:

Предлагаю для приведения в соответствие названия раздела и его содержания либо добавить в раздел описание подключения к шлюзу канального окончания xxxx, либо изменить название раздела.

Странно, что я цитирую описания других тикетов в комментарии к этому, когда ты мог сразу прочитать мои предложения в первоисточниках...

Я же уже сообщал, что на мой взгляд
"в РЭ-50 все подключения для всех КО, вроде как, прописаны."

А я уже отвечал, что, на мой взгляд, это, вроде как, не так. :) И что?

[Vladimir]

Replying to alx:

Replying to Vladimir:
Мой comment:3 был ответом на твой comment:1, в котором, ты, как мне показалось, неверно интерпретировал мысли, которые я изложил в описании тикета (приписал мне мнение, что нужно удалить фрагмент пункта 7.1). Я постарался пояснить свое мнение подробнее.

Т.е. нужно вернуть в "7.1 Общая информация" абзац про полупостоянные потоки?

.... не обращай внимания на написанное в comment:3 начиная с "Я могу...".

Т.е. все 10 предложенных тобой абзацев желательно вставить именно в
"7.1 Общая информация"? Но это уже прописано в соответствующих пунктах
от 7.4.1 до 7.4.63, например:
"7.4.1 Тип окончания – FXS / Подключение к шлюзу окончания FXS
................
Для подключения к шлюзу нового абонента зайдите на вкладку Канальные окончания
(см. Рис. 7.11) и нажмите кнопку +Добавить, выберите в выпадающем меню тип канального окончания FXS и нажмите кнопку ОК – откроется окно на вкладке Параметры (Рис. 7.14):....."

В комменте-5 ты написал:
"А мой comment:3 дальше середины ты не осилил? :) Потому что там я написал, что это не так.", а что конкретно "не так"

Не так то, что твое утверждение о том, что в РЭ-50 все подключения для всех КО прописаны, вроде как, не соответствует действительности.

Про FXS я уже привёл текст выше, во всех остальных КО есть подобные тексты,
если я что-то пропустил, то приведи номера пунктов, где нет подобного текста...

Я же уже сообщал, что на мой взгляд
"в РЭ-50 все подключения для всех КО, вроде как, прописаны."

А я уже отвечал, что, на мой взгляд, это, вроде как, не так. :) И что?

Это "голословно" - приведи из раздела 7.4 номера пунктов,
в которых не прописано подключение к шлюзу КО.
Если хочешь, то могу скопировать сюда все 10 абзацев РЭ про подключение КО :-)

[alx]

Replying to Vladimir:

Т.е. нужно вернуть в "7.1 Общая информация" абзац про полупостоянные потоки?

Я так не считаю, о чем уже ответил тебе в comment:7. Непонятно, почему ты опять об этом спрашиваешь. Не прочитал мой комментарий?

В описании тикета я предложил тебе два альтернативных варианта улучшения:

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

И об этом я тоже уже писал в comment:3. Мы ходим по кругу...

Т.е. все 10 предложенных тобой абзацев желательно вставить именно в
"7.1 Общая информация"?

Такого пожелания в моем предложении нет.

Не так то, что твое утверждение о том, что в РЭ-50 все подключения для всех КО прописаны, вроде как, не соответствует действительности.

Про FXS я уже привёл текст выше,

Не понимаю, зачем ты привел выше текст про FXS, если в comment:3 я не писал о том, что в разделе о FXS не описано его подключение к шлюзу...

во всех остальных КО есть подобные тексты,

Уточни, пожалуйста, где прячется описание действий по подключению, например, канального окончания R2DTMF в пункте 7.4.40. Только что еще раз перечитал этот пункт и не нашел. Там написано назначение канального окончания, и какие СУВ используются для передачи линейных сигналов. И это все. Никаких действий по подключению там не описано...

если я что-то пропустил, то приведи номера пунктов, где нет подобного текста...

Номера пунктов приведены мной в comment:3. Не понимаю, почему ты хочешь, чтобы я повторил в этом комменте написанное в comment:3 вместо того чтобы сразу прочитать написанное в comment:3. У тебя что, текст comment:3 не отображается на дисплее? :)

Я же уже сообщал, что на мой взгляд
"в РЭ-50 все подключения для всех КО, вроде как, прописаны."

А я уже отвечал, что, на мой взгляд, это, вроде как, не так. :) И что?

Это "голословно" - приведи из раздела 7.4 номера пунктов,
в которых не прописано подключение к шлюзу КО.

Номера пунктов приведены в comment:3, а также в соответствующих тикетах (также указанных в comment:3). То, что ты не не желаешь прочитать написанное мной, не является основанием утверждать, что мои утверждения голословны.

Если хочешь, то могу скопировать сюда все 10 абзацев РЭ про подключение КО :-)

Я в этом не сомневаюсь. :)

[Vladimir]

Replying to alx:

Replying to Vladimir:

Т.е. нужно вернуть в "7.1 Общая информация" абзац про полупостоянные потоки?

Я так не считаю, о чем уже ответил тебе в comment:7. Непонятно, почему ты опять об этом спрашиваешь. Не прочитал мой комментарий?

Очень просто: в Комм-10 ты записал: "ты неверно интерпретировал мысли, которые я изложил в описании тикета (приписал мне мнение, что нужно удалить фрагмент пункта 7.1)."

• я это понял так, что раз неверно мнение "удалить", значит, верное мнение "вернуть" :-)

Т.е. все 10 предложенных тобой абзацев желательно вставить именно в
"7.1 Общая информация"?

Такого пожелания в моем предложении нет.

Хорошо, я тоже не хотел вставлять в 7.1.

Не так то, что твое утверждение о том, что в РЭ-50 все подключения для всех КО прописаны, вроде как, не соответствует действительности.

Про FXS я уже привёл текст выше,

Не понимаю, зачем ты привел выше текст про FXS, если в comment:3 я не писал о том, что в разделе о FXS не описано его подключение к шлюзу...

Это я привёл только в качестве примера, чтобы не приводить все 10 подобных абзацев.

во всех остальных КО есть подобные тексты,

Уточни, пожалуйста, где прячется описание действий по подключению, например, канального окончания R2DTMF в пункте 7.4.40. Только что еще раз перечитал этот пункт и не нашел. Там написано назначение канального окончания, и какие СУВ используются для передачи линейных сигналов. И это все. Никаких действий по подключению там не описано...

Очень хорошо, что заметил то, что я пропустил, но плохо, что сразу не указал на 7.4.40 -
я бы уже давно добавил :-)
Хотя, я проверял это в текущем РЭ-51 (пока только на диске Х: в моей папке), а там прописано:
"Для создания окончания R2DTMF зайдите на вкладку Канальные окончания (Рис. 7.11)
и нажмите кнопку Добавить – появится диалог выбора типа канального окончания, после выбора
в нем типа R2DTMF и нажатия OK откроется окно как на Рис. 7.49"

И про PPS в РЭ-51 прописано:
"Для создания канального окончания PPS необходимо после установки соединения
с блоком в браузере и аутентификации (см. пункт 6.1.2) открыть web-интерфейс на вкладке Платы (Рис. 6.4), выбрать плату VE-01 / VE-01, вкладку Канальные окончания, кликнуть на кнопке +Добавить, в открывшемся окне добавления выбрать тип канального окончания PPS (Ретрансляторы ППС-Р3), и тогда откроется окно с параметрами окончания PPS (Рис. 7.58):"

И про АДАСЭ:
"Для создания окончания АДАСЭ зайдите на вкладку Канальные окончания (Рис. 7.11)
и нажмите кнопку Добавить – появится диалог выбора типа канального окончания, после выбора
в нем типа АДАСЭ и нажатия OK откроется окно как на Рис. 7.54"

И про МБ:
"Для создания окончания МБ зайдите на вкладку Канальные окончания (Рис. 7.11)
и нажмите кнопку Добавить – появится диалог выбора типа канального окончания, после выбора
в нем типа МБ и нажатия OK откроется окно как на Рис. 7.56"

Номера пунктов приведены мной в comment:3. Не понимаю, почему ты хочешь, чтобы я повторил в этом комменте написанное в comment:3 вместо того чтобы сразу прочитать написанное в comment:3. У тебя что, текст comment:3 не отображается на дисплее? :)

Я, видимо, сразу, по первому замечанию, не глядя на комменты и тикеты
добавил подключения во все КО :-)

[Vladimir]

В РЭ-51 добавлено "подключение" во все КО ( см.Комм-12)

[alx]

Replying to Vladimir:

Очень просто: в Комм-10 ты записал: "ты неверно интерпретировал мысли, которые я изложил в описании тикета (приписал мне мнение, что нужно удалить фрагмент пункта 7.1)."

• я это понял так, что раз неверно мнение "удалить", значит, верное мнение "вернуть" :-)

Ты понял неправильно. Из факта, что я не считаю, что нужно удалить фрагмент пункта 7.1, не следует вывод, что я считаю, что нужно этот фрагмент вернуть. :)

Т.е. все 10 предложенных тобой абзацев желательно вставить именно в
"7.1 Общая информация"?

Такого пожелания в моем предложении нет.

Хорошо, я тоже не хотел вставлять в 7.1.

Однако описание действий по созданию полупостоянного потока RTP ты в свое время вставил именно туда.

Не понимаю, зачем ты привел выше текст про FXS, если в comment:3 я не писал о том, что в разделе о FXS не описано его подключение к шлюзу...

Это я привёл только в качестве примера,

В качестве примера чего?

Очень хорошо, что заметил то, что я пропустил, но плохо, что сразу не указал на 7.4.40 -

Это неправда. Я сразу указал на пункт 7.4.40 и в comment:3, и в трех созданных мной тикетах. То, что ты не прочитал написанного мной в комментарии, не является основанием утверждать, что я этого не указал.

я бы уже давно добавил :-)

Что же тебе помешало (кроме нежелания прочитать то, что я пишу)? :)

[Vladimir]

Replying to alx:

Replying to Vladimir:
Я сразу указал на пункт 7.4.40 и в comment:3, и в трех созданных мной тикетах.
Что же тебе помешало (кроме нежелания прочитать то, что я пишу)? :)

МВН и АЕН часто меня отрывает на неотложные дела по другим заказам/проектам,
поэтому я всё бросаю и кидаюсь срочно выполнять новые поручения, рисовать схемы,
а потом могу частично упустить из вида подробности...
Хорошо, что хоть ты всё помнишь и напоминаешь! :-)

[alx]

Replying to Vladimir:

МВН и АЕН часто меня отрывает на неотложные дела по другим заказам/проектам,
поэтому я всё бросаю и кидаюсь срочно выполнять новые поручения, рисовать схемы,
а потом могу частично упустить из вида подробности...

Но ведь комментарии из тикета никуда не исчезают, пока ты выполняешь новые поручения. :) После выполнения новых поручений можно их перечитать и освежить в памяти подробности...

Хорошо, что хоть ты всё помнишь и напоминаешь! :-)

Я не помню, я, прежде чем написать ответный комментарий, просматриваю предыдущие чтобы освежить в памяти контекст. Для того мы и завели trac, чтобы не было необходимости все помнить самому, а можно было в нужное время перечитать комментарии, которые компьютер помнит за меня. :)

[san]

Milestone deleted