Opened 5 years ago

Closed 3 years ago

Last modified 22 months ago

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

РЭ: бессмысленное цитирование

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

Description

В РЭ аппаратуры MC04-DSL-3U редакции 40 в разделе 7.1.1 цитируется текст статьи wiki-странички sip_ua:FunctionsSipProxy. Эта статья написана в момент изменения внутренней архитектуры платы VE-01 (появления в ней прокси-сервера) и в ней сравниваются старый вариант архитектуры с новым и описываются преимущества нового варианта по сравнению со старым (раздел "Различия в функционировании").

В РЭ же по понятным причинам описана только "новая" архитектура, которая существует в последних ревизиях прошивок VE-01! В результате читатель, читая цитаты раздела "Различия в функционировании" вики-статьи, не понимает, различия между чем и чем здесь описаны. Например, когда в тексте говорится:

...а сами записи CDR "привязаны" не к канальному окончанию шлюза, а к конкретному вызову

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

Считаю, что различия в функционировании старых и новых ревизий прошивки, скопированное из wiki-статьи, не несет полезной информации для читателя. Предлагаю убрать его из текста РЭ, оставив только описание того, что есть сейчас.

Change History (6)

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

Replying to alx:

В РЭ аппаратуры MC04-DSL-3U редакции 40 в разделе 7.1.1 цитируется текст статьи wiki-странички sip_ua:FunctionsSipProxy.
В РЭ же по понятным причинам описана только "новая" архитектура, которая существует в последних ревизиях прошивок VE-01! ...

...а сами записи CDR "привязаны" не к канальному окончанию шлюза, а к конкретному вызову

Считаю, что различия в функционировании старых и новых ревизий прошивки, скопированное из wiki-статьи, не несет полезной информации для читателя. Предлагаю убрать его из текста РЭ, оставив только описание того, что есть сейчас.

Т.е. предлагаешь записать короче:
"...а сами записи CDR "привязаны" к конкретному вызову" - Так правильно?

Лучше ты сразу записал, как надо - это же короче и я бы не сомневался
в том, что вижу первый раз в жизни! :-)

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

Replying to Vladimir:

Т.е. предлагаешь записать короче:
"...а сами записи CDR "привязаны" к конкретному вызову" - Так правильно?

Да, так правильно, но и так, как сейчас - тоже правильно. Я не утверждал, что написанное - неправильно. Я считаю (и написал об этом), что сравнение со старым вариантом, который без прокси-сервера, бессмысленно, ненужно и даже вредно, так как читателю непонятно, о чем речь (в данном конкретном примере - при чем тут канальное окончание шлюза).

Лучше ты сразу записал, как надо - это же короче и я бы не сомневался
в том, что вижу первый раз в жизни! :-)

А разве не ты это написал в РЭ?

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

Replying to alx:

Replying to Vladimir:

Т.е. предлагаешь записать короче:
"...а сами записи CDR "привязаны" к конкретному вызову" - Так правильно?

Да, так правильно,

Лучше ты сразу записал, как надо - это же короче и я бы не сомневался
в том, что вижу первый раз в жизни! :-)

А разве не ты это написал в РЭ?

Как я могу что-то правильное записать, если не знаю подробностей! :-)
Я обычно копирую тексты Авторов или Знатоков (Анатолий, САН и др.).
Если я что-то пишу по своему недоразумению, то сразу затягивается длительная переписка,
в которой я много раз пытаюсь угадать правильный текст, а ты много раз пытаешься навести меня на правильную мысль, объясняешь, вместо того, чтобы 1 раз дать конкретный текст для почти прямой вставки в РЭ.
Вот с Ледол или Вадимом у меня не бывает длинных дебатов:
Ледол печатает текст в формате txt и говорит, что должно быть точно так, только в Ворде,
а Вадим берёт файл РЭ в Ворде, печатает там свой текст, "красит" жёлтой заливкой и отсылает мне, добавив, например слово Vadim названии файла, ну, или делает отдельный файл описания.

Ты часто тоже очень удобно для меня и себя делаешь, например:
"#488 closed задача (готово)
Добавить в РЭ: новый тип канального окончания EM плат VE-01 и VE-02"
и даёшь ссылку: "Подробное описание этого типа окончаний можно посмотреть ​здесь....",
по которой я в первом же комменте закрываю тикет!
И тебе хорошо: не надо печатать длинные объяснения,
и мне хорошо: не надо ни о чём спрашивать, а только вставить и отформатировать с стиле РЭ :-)

Для правильного и подробного описания надо быть или автором изделия,
или очень активным пользователем (как, например САН)...
Кто что придумал, тот и должен бы подробно рассказать о своих придумках,
что ты часто и делаешь: без тебя я ничего не смог бы толком напечатать :-)

in reply to:  3 ; comment:4 by alx, 3 years ago

Replying to Vladimir:

Replying to alx:

Replying to Vladimir:

Т.е. предлагаешь записать короче:
"...а сами записи CDR "привязаны" к конкретному вызову" - Так правильно?

Да, так правильно,

Лучше ты сразу записал, как надо - это же короче и я бы не сомневался
в том, что вижу первый раз в жизни! :-)

А разве не ты это написал в РЭ?

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

Странно... Тикет #163 закрыл именно ты, поэтому я был уверен, что обсуждаемый текст в РЭ записал ты...

Если я что-то пишу по своему недоразумению, то сразу затягивается длительная переписка,
в которой я много раз пытаюсь угадать правильный текст, а ты много раз пытаешься навести меня на правильную мысль, объясняешь, вместо того, чтобы 1 раз дать конкретный текст для почти прямой вставки в РЭ.

Ну это как-бы не моя работа... :)

Ты часто тоже очень удобно для меня и себя делаешь, например:
"#488 closed задача (готово)
Добавить в РЭ: новый тип канального окончания EM плат VE-01 и VE-02"
и даёшь ссылку: "Подробное описание этого типа окончаний можно посмотреть ​здесь....",
по которой я в первом же комменте закрываю тикет!
И тебе хорошо: не надо печатать длинные объяснения,
и мне хорошо: не надо ни о чём спрашивать, а только вставить и отформатировать с стиле РЭ :-)

В тикете #163 была дана ссылка на описание новой архитектуры платы VE-01 (с прокси-сервером).

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

Resolution: готово
Status: newclosed

Replying to alx:

Replying to Vladimir:

"...а сами записи CDR "привязаны" к конкретному вызову" - Так правильно?

Да, так правильно,

Если я что-то пишу по своему недоразумению, то сразу затягивается длительная переписка,
в которой я много раз пытаюсь угадать правильный текст, а ты много раз пытаешься навести меня на правильную мысль, объясняешь, вместо того, чтобы 1 раз дать конкретный текст для почти прямой вставки в РЭ.

Ну это как-бы не моя работа... :)

Тогда будем продолжать читать и печатать тысячи новых комментов,
т.к. я, как не Автор VE, не всегда могу угадать правильный текст. :-)
А дело у нас общее - правильная РКД.
В Такте я не помню, чтобы кто-то вместо меня описывал то, что я придумал и разработал

Ты часто тоже очень удобно для меня и себя делаешь, например:
"#488 closed задача (готово)
Добавить в РЭ: новый тип канального окончания EM плат VE-01 и VE-02"
и даёшь ссылку: "Подробное описание этого типа окончаний можно посмотреть ​здесь....",
по которой я в первом же комменте закрываю тикет!
И тебе хорошо: не надо печатать длинные объяснения,
и мне хорошо: не надо ни о чём спрашивать, а только вставить и отформатировать с стиле РЭ :-)

В тикете #163 была дана ссылка на описание новой архитектуры платы VE-01 (с прокси-сервером).

По этой ссылке в РЭ-51 есть отдельный пункт:
"7.1.1 Программно-аппаратная архитектура плат VE"
с твоими красивыми картинками, т.е. на мой взгляд это реализовано в РЭ

comment:6 by san, 22 months ago

milestone: 1 очередь

Milestone deleted

Note: See TracTickets for help on using tickets.