#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)
follow-up: 2 comment:1 by , 3 years ago
follow-up: 3 comment:2 by , 3 years ago
Replying to Vladimir:
Т.е. предлагаешь записать короче:
"...а сами записи CDR "привязаны" к конкретному вызову" - Так правильно?
Да, так правильно, но и так, как сейчас - тоже правильно. Я не утверждал, что написанное - неправильно. Я считаю (и написал об этом), что сравнение со старым вариантом, который без прокси-сервера, бессмысленно, ненужно и даже вредно, так как читателю непонятно, о чем речь (в данном конкретном примере - при чем тут канальное окончание шлюза).
Лучше ты сразу записал, как надо - это же короче и я бы не сомневался
в том, что вижу первый раз в жизни! :-)
А разве не ты это написал в РЭ?
follow-up: 4 comment:3 by , 3 years ago
Replying to alx:
Replying to Vladimir:
Т.е. предлагаешь записать короче:
"...а сами записи CDR "привязаны" к конкретному вызову" - Так правильно?
Да, так правильно,
Лучше ты сразу записал, как надо - это же короче и я бы не сомневался
в том, что вижу первый раз в жизни! :-)
А разве не ты это написал в РЭ?
Как я могу что-то правильное записать, если не знаю подробностей! :-)
Я обычно копирую тексты Авторов или Знатоков (Анатолий, САН и др.).
Если я что-то пишу по своему недоразумению, то сразу затягивается длительная переписка,
в которой я много раз пытаюсь угадать правильный текст, а ты много раз пытаешься навести меня на правильную мысль, объясняешь, вместо того, чтобы 1 раз дать конкретный текст для почти прямой вставки в РЭ.
Вот с Ледол или Вадимом у меня не бывает длинных дебатов:
Ледол печатает текст в формате txt и говорит, что должно быть точно так, только в Ворде,
а Вадим берёт файл РЭ в Ворде, печатает там свой текст, "красит" жёлтой заливкой и отсылает мне, добавив, например слово Vadim названии файла, ну, или делает отдельный файл описания.
Ты часто тоже очень удобно для меня и себя делаешь, например:
"#488 closed задача (готово)
Добавить в РЭ: новый тип канального окончания EM плат VE-01 и VE-02"
и даёшь ссылку: "Подробное описание этого типа окончаний можно посмотреть здесь....",
по которой я в первом же комменте закрываю тикет!
И тебе хорошо: не надо печатать длинные объяснения,
и мне хорошо: не надо ни о чём спрашивать, а только вставить и отформатировать с стиле РЭ :-)
Для правильного и подробного описания надо быть или автором изделия,
или очень активным пользователем (как, например САН)...
Кто что придумал, тот и должен бы подробно рассказать о своих придумках,
что ты часто и делаешь: без тебя я ничего не смог бы толком напечатать :-)
follow-up: 5 comment:4 by , 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 (с прокси-сервером).
comment:5 by , 3 years ago
Resolution: | → готово |
---|---|
Status: | new → closed |
Replying to alx:
Replying to Vladimir:
"...а сами записи CDR "привязаны" к конкретному вызову" - Так правильно?
Да, так правильно,
Если я что-то пишу по своему недоразумению, то сразу затягивается длительная переписка,
в которой я много раз пытаюсь угадать правильный текст, а ты много раз пытаешься навести меня на правильную мысль, объясняешь, вместо того, чтобы 1 раз дать конкретный текст для почти прямой вставки в РЭ.
Ну это как-бы не моя работа... :)
Тогда будем продолжать читать и печатать тысячи новых комментов,
т.к. я, как не Автор VE, не всегда могу угадать правильный текст. :-)
А дело у нас общее - правильная РКД.
В Такте я не помню, чтобы кто-то вместо меня описывал то, что я придумал и разработал
Ты часто тоже очень удобно для меня и себя делаешь, например:
"#488 closed задача (готово)
Добавить в РЭ: новый тип канального окончания EM плат VE-01 и VE-02"
и даёшь ссылку: "Подробное описание этого типа окончаний можно посмотреть здесь....",
по которой я в первом же комменте закрываю тикет!
И тебе хорошо: не надо печатать длинные объяснения,
и мне хорошо: не надо ни о чём спрашивать, а только вставить и отформатировать с стиле РЭ :-)
В тикете #163 была дана ссылка на описание новой архитектуры платы VE-01 (с прокси-сервером).
По этой ссылке в РЭ-51 есть отдельный пункт:
"7.1.1 Программно-аппаратная архитектура плат VE"
с твоими красивыми картинками, т.е. на мой взгляд это реализовано в РЭ
Replying to alx:
Т.е. предлагаешь записать короче:
"...а сами записи CDR "привязаны" к конкретному вызову" - Так правильно?
Лучше ты сразу записал, как надо - это же короче и я бы не сомневался
в том, что вижу первый раз в жизни! :-)