РЭ: ненужная информация в описании плат VE-01/VE-02

[alx]

В РЭ аппаратуры MC04-DSL-3U редакции 40 в разделе 7.2 на странице 203 написано:

При изменении IP-настроек платы необходимо перезагрузить плату, нажав кнопку Рестарт. Начиная с 20-ой ревизии прошивки платы, рестарт делать нет необходимости.

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

[Vladimir]

А если у кого-то до сих пор установлена и работает одна из предыдущих 19 прошивок?
РЭ на сайте могут читать и юзеры всех прошивок, а у кого-то по старой памяти сохранилась в голове информация о необходимости перезагрузки, то после прочтения этой фразы он, возможно, запомнит, что теперь перезагрузку делать не надо. Разве это плохо?

[san]

А если у кого-то до сих пор установлена и работает одна из предыдущих 19 прошивок?

Нужно срочно посоветовать ему обновиться до актуальной ревизии. Если вы знаете такого пользователя, подскажите ему.

[Vladimir]

Дело в том, что АДС не может точно знать обо всех сотнях юзеров текущее состояние их МС04 и ПО

• вот поэтому в новых РЭ полезно напомнить всем юзерам, что

"Начиная с 20-ой ревизии прошивки платы, рестарт делать нет необходимости".
Я предполагаю, что 99,9% всех юзероав не помнят наизусть номер текущей версии ПО.

Кстати: а если кто-то в 20-й и далее версии нажмёт кнопку Рестарт,
то что случится - МС04 взорвётся, или слетят все настройки всего ПО ? :-)

[alx]

Replying to Vladimir:

А если у кого-то до сих пор установлена и работает одна из предыдущих 19 прошивок?

Не понял вопрос. Что "а если"? Что в этом случае делать? Обновить прошивку.

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

Это очень хорошо! Но надо быть последовательным, и следовать этому принципу во всем, а не только в описании настроек IP!

Например, начиная с r1725 изменился порядок установки плат в кассету при использовании варианта веб-интерфейса "IP-АТС": ранее требовалось устанавливать плату VE-01 в слот 1, а начиная с r1725 ее надо устанавливать в слот 10. В текст РЭ было внесено соответствующее изменение. Но сохранилось ли в РЭ указание на то, что при использовании пакета sw ревизии ниже r1725 плату VE-01 надо устанавливать в слот 1? По-моему, нет. Как же так? Откроет пользователь, до сих пор использующий пакет sw ревизии ниже r1725 РЭ, прочитает его, установит VE-01 в слот 10 - и будет у него что-нибудь работать неправильно!

Или другой пример. Начиная с ​sw:r1489 в web-интерфейсе было изменено добавление/редактирование SIP-пользователей. В РЭ было внесено соответствующее изменение. Но было ли сохранено в РЭ описание добавления SIP-пользователя, как оно было до r1489? По-моему, нет. А как же так? Захочет пользователь, до сих пор использующий пакет sw более старой ревизии, чем r1489, добавить SIP-пользователя, откроет РЭ редакции 40 - а там не написано, как это сделать для его ревизии пакета!

Будь последователен, и описывай тогда все особенности всех более ранних ревизий всех пакетов! Правда размер РЭ станет в несколько раз больше, но зато им сможет руководствоваться пользователь с любой ревизией любого пакета...

[alx]

Replying to Vladimir:

Кстати: а если кто-то в 20-й и далее версии нажмёт кнопку Рестарт,
то что случится - МС04 взорвётся, или слетят все настройки всего ПО ? :-)

Что случится при нажатии кнопки "Рестарт", должно быть написано в Руководстве по эксплуатации. Разве не написано? :) Надо написать. Будет выполнен рестарт платы. :)

[Vladimir]

На Рис. 7.9 Вкладка Настройки платы VE-01
есть кнопка "Рестарт" и есть единственное упоминание про эту кнопку для платы VE-01 - это в той фразе, которую ты предлагаешь удалить на стр.203.
Остальные упоминания про Рестарт только на стр.16(SW), 32(SM), 49(TE-01) и 51(ТЕ-04).
Прочитав 203 страницы текста вряд ли кто вспомнит про описание кнопки Рестарт,
поэтому первую строчку твоей цитаты надо бы оставить
(При изменении IP-настроек платы необходимо перезагрузить плату, нажав кнопку Рестарт.)
а вторую строчку про 20-ю ревизию можно и убрать,
("Начиная с 20-ой ревизии прошивки платы, рестарт делать нет необходимости."),
хотя я бы оставил (не вижу вреда от нажатия на Рестарт,
а вот польза для забывчивых напомнить об этом удобстве есть),
но Разработчикам-Авторам плат и ПО виднее :-)
Если Саша согласен убрать, то уберу, мне не жалко.

[Vladimir]

А м.б. в РЭ рисунок окна настройки VE устаревший,
тогда пришлите новый рисунок без кнопки Рестарт.

[san]

Если Саша согласен убрать, то уберу, мне не жалко.

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

[Vladimir]

В РЭ-41 удалил,
но тогда зачем кнопка Рестарт в окне настроек VE,
если её назначение не надо описывать?
Будут же лишние вопросы от излишне любопытных юзеров...

[alx]

Replying to Vladimir:

Прочитав 203 страницы текста вряд ли кто вспомнит про описание кнопки Рестарт,
поэтому первую строчку твоей цитаты надо бы оставить
(При изменении IP-настроек платы необходимо перезагрузить плату, нажав кнопку Рестарт.)

Хм... Это утверждение мне кажется странным и удивительным сразу по двум причинам.

Во-первых, я не вижу в нем логики: каким образом из трудности вспоминания описания кнопки Рестарт (которого, как выясняется, нет) следует необходимость оставить первую строчку процитированного текста? По-моему, никак.

Во-вторых, первая строчка цитаты не соответствует действительности. Желание оставить в тексте РЭ несоответствующее действительности утверждения я нахожу, мягко говоря, странным...

[alx]

Replying to Vladimir:

А м.б. в РЭ рисунок окна настройки VE устаревший,

Да, в РЭ редакции 40 рисунок 7.9 устаревший.

тогда пришлите новый рисунок без кнопки Рестарт.

??? Непонятно, зачем присылать рисунок без кнопки "Рестарт", если в действительности кнопка "Рестарт" есть...

[alx]

Replying to Vladimir:

но тогда зачем кнопка Рестарт в окне настроек VE,
если её назначение не надо описывать?

К кому вопрос? Кто сказал, что кнопку "Рестарт" не надо описывать? Я, например, в comment:5 наоборот, говорил, что надо...

Будут же лишние вопросы от излишне любопытных юзеров...

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

[Vladimir]

Если рисунок 7.9 устаревший, то пришли новейший рисунок и я заменю устаревший,
но если и в новейшем есть Рестарт, то что про него правильно написать:
для чего нужен рестарт для платы VE - в каких случаях нажимать эту кнопку?
(я эту кнопку для VE ни разу в жизни не нажимал :-) ).
Напиши кратко то, что считаешь нужным и правильным для РЭ про Рестарт в окне VE.

[alx]

Replying to Vladimir:

Если рисунок 7.9 устаревший, то пришли новейший рисунок и я заменю устаревший,

Новейший рисунок приложен к тикету #480:

Напиши кратко то, что считаешь нужным и правильным для РЭ про Рестарт в окне VE.

Кратко я это уже написал в comment:5. :) Но если более развернуто, то:

Кнопка "Рестарт" производит полную перезагрузку платы.

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

[Vladimir]

Спасибо, но в РЭ для этого пункта и рисунка окна VE ещё нет слов про кнопку "Журналирование"
и про "Ключи SSH". Про журналирование могу сослаться на пункт:
"6.2.22 Вкладка CDR – журналирование выполняемых вызовов"
Это будет уместно в п.7.2 настройки VE ?
Или лучше привести одну строчку с определением этого понятия
(если лучше кратко описать, то предложи вариант).

Поиск по сочетанию "SSH" дал три упоминания: на стр.48 про SW-01,
но описания или хотя бы расшифровки этих букв нет,
есть только упоминание про некий неизвестный "сервер SSH" и "SSH-клиент".
Хорошо бы это тоже уточнить в РЭ хотя бы кратко...

Расшифровку сочетания SSL в РЭ я тоже не нашёл
(встречается 4 раза как "Сертификат SSL").
Хотелось бы при чтении РЭ обходиться без Гугла и Яндекса...

[alx]

Replying to Vladimir:

Спасибо, но в РЭ для этого пункта и рисунка окна VE ещё нет слов про кнопку "Журналирование"
и про "Ключи SSH". Про журналирование могу сослаться на пункт:
"6.2.22 Вкладка CDR – журналирование выполняемых вызовов"
Это будет уместно в п.7.2 настройки VE ?

Пожалуй, нет. Не вижу необходимости в такой ссылке.

Или лучше привести одну строчку с определением этого понятия
(если лучше кратко описать, то предложи вариант).

Что-то я запутался... Этот тикет я создал чтобы предложить убрать бессмысленное и, на мой взгляд, странное упоминание о том, что в каких-то из давно устаревших ревизиях прошивки платы после изменения настроек IP надо было выполнять рестарт платы. Какое отношение ссылка на раздел CDR, о которой ты пишешь, имеет к моему предложению? Вариант чего ты от меня хочешь? Мне кажется, вариантов может быть только два:

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

При чем тут CDR и SSH?

[Vladimir]

Твоё предложение принимаю и уже удалил из РЭ-41 твою цитату,
но увидел в твоём обновлённом рисунке кнопку "Журналирование"
и подумал, что уж заодно в этом же пункте дать описание этой кнопки.
Если описание не требуется, то его и не будет.

Одновременно с кнопкой "Журналирование" я обратил внимание,
что в этом же окне на Рис.7.9 присутствует кнопка "Ключи SSH",
на которую тоже нет никакого описания, а SSH вообще нигде в РЭ
не расшифровано - так уж заодно надо и его расшифровать для ясности,
это же всё в одном и том же пункте на одной и той же странице.

В некоторых случаях ты требуешь описание всех без исключения кнопок,
включая, например, кнопку "ОК", а тут тоже есть не описанные кнопки и понятия
и на мой взгляд их надо бы как-то расшифровать...
Я, например, сей момент не помню, что такое SSH (как и SSL)
и думаю, что я не один такой, даже в АДС :-)

Если ты и Саша скажете, что про SSH (как и SSL) юзерам и не надо знать,
и описание кнопки "Ключи SSH" не требуется, то не буду это добавлять и закрою тикет.

[alx]

Replying to Vladimir:

Твоё предложение принимаю и уже удалил из РЭ-41 твою цитату,
но увидел в твоём обновлённом рисунке кнопку "Журналирование"
и подумал, что уж заодно в этом же пункте дать описание этой кнопки.

Это все, конечно, чрезвычайно интересно и замечательно! Странно только, что ты об этом почему-то пишешь в комментариях к тикету, написанному на совершенно другую тему, а не в уже упомянутом выше тикете #480, в котором как раз и было предложено добавить описание кнопки "Журналирование"...

[Vladimir]

Тикет 480 был 4 месяца назад, меня отвлекли на другие
скоропостижные и неспихуемые дела, поэтому 480 ушёл на задний план,
спасибо, что напомнил - постараюсь закрыть и 480.

А про описание SSH (как и SSL), в частности про кнопку "Ключи SSH) был тикет?
Если нет, то можешь ли кратко описать?

[alx]

Replying to Vladimir:

А про описание SSH (как и SSL), в частности про кнопку "Ключи SSH) был тикет?

В trac есть функция поиска, с помощью которой можно найти тикеты, в которых упоминаются нужные слова. Да, по SSH есть тикет: #163.

И еще, ты, наверняка, это и так это знаешь, но на всякий случай напомню, что посмотреть в проекте mc-04 trac все открытые тикеты, владельцем которых ты являешься, можно в разделе просмотр карточек --> Мои тикеты.

[Vladimir]

В РЭ-41 абзац про Рестарт удалил, Рис.7.9 заменил на новый,
добавил краткую запись про Рестар в конце пункта 7.2:
"При нажатии кнопки Рестарт произойдёт полная перезагрузка платы."
а про про Журналирование и SSH закрою в тикетах #163 и #480.

[san]

Milestone deleted