Opened 6 years ago

Closed 5 years ago

Last modified 22 months ago

#232 closed дефект (готово)

Ошибка в РЭ: резервирование SW-01

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

Description (last modified by alx)

В РЭ аппаратуры MC04-DSL-3U редакции 33 на странице 8 есть такой пункт:

резервирование платы SW-01, выполняющей функции коммутатора TDM-каналов, центрального коммутатора Ethernet, управления и мониторинга

Из этого пункта читатель ошибочно сделает вывод, что резервируется вся плата SW-01, то есть все ее функции, включая функцию коммутации ethernet. На самом деле резервироваться может только часть функций платы SW-01, например функция коммутации каналов TDM, опрос и конфигурирование других плат блока. А вот как раз упомянутая здесь функция коммутации пакетов ethernet не резервируется.

Необходимо исправить формулировку пункта.

Change History (9)

comment:1 by Vladimir, 5 years ago

"...функция коммутации каналов TDM, опрос и конфигурирование других плат блока и т.п."

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

Фразу "...центрального коммутатора Ethernet..." надо удалить из этого перечня?

Точно сформулировать сможет только тот, кто придумал и реализовал все эти функции, т.е. автор платы SW-01 или тот, кто сам проверил все эти функции резервирования.

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

Replying to Vladimir:

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

Согласен. В тексте РЭ писать "т.п." не надо.

Фразу "...центрального коммутатора Ethernet..." надо удалить из этого перечня?

Нет, не надо. Функцию коммутации кадров ethernet плата SW-01, действительно, выполняет. Ошибка здесь не в том, что перечень выполняемых платой SW-01 функцией неверный, а в том, что отсутствует уточнение о том, что функция резервирования выполняется не для всех функций платы SW-01, а только для функций коммутации каналов TDM, управления и мониторинга (а для коммутации ethernet - нет). Необходимо добавить это уточнение.

comment:3 by san, 5 years ago

В РЭ-41 этот пункт выглядит так

1.1.2 Преимущества применения ЦСП MC04−DSL:
 поддержка VLAN Ethernet (IEEE 802.1Q);
 резервирование плат питания;
 резервирование платы SW-01, выполняющей функции коммутатора TDM-каналов, центрального коммутатора Ethernet, управления и мониторинга;

Согласен с Алексеем и предлагаю такую формулировку:
1.1.2 Преимущества применения ЦСП MC04−DSL:
 поддержка VLAN Ethernet (IEEE 802.1Q);
 резервирование плат питания;
 резервирование центральной платы SW-01(резервирование функций коммутатора TDM-каналов, управления и мониторинга);

comment:4 by alx, 5 years ago

Также добавлю, что "и т.п." встречается в тексте проекта РЭ-41 11 раз. :)

comment:5 by Vladimir, 5 years ago

В РЭ-41 вставил фразу от САН:

"резервирование центральной платы SW-01(резервирование функций коммутатора TDM-каналов, управления и мониторинга)"

Теперь Алекс считает это правильным и даже без "и т.п."?
Или надо что-то ещё добавить из группы загадочных "и т.п."?

Я готов заменить все 11 "и т.п." на то, что надо, только напишите:
зачем заставлять пользователей гадать, ломать голову, долго искать, задавать всем вопросы...

Этот Тикет уже можно закрыть или продолжим дебаты?

in reply to:  5 comment:6 by alx, 5 years ago

Replying to Vladimir:

В РЭ-41 вставил фразу от САН:

"резервирование центральной платы SW-01(резервирование функций коммутатора TDM-каналов, управления и мониторинга)"

Теперь Алекс считает это правильным и даже без "и т.п."?

В приведенной фразе уточнение, которое предлагал Алекс, добавлено - Алекс считает это правильным. Даже без "т.п.".

Или надо что-то ещё добавить из группы загадочных "и т.п."?

Кроме уточнения, говорящего о том, что не все функции платы резервируются, а только часть из них, Алекс ничего добавлять не предлагал.

Я готов заменить все 11 "и т.п." на то, что надо, только напишите:
зачем заставлять пользователей гадать, ломать голову, долго искать, задавать всем вопросы...

Лично я против "т.п." ничего не имею. Это ты сказал выше, что читатель подумает, будто автор сам не знает. Автор - ты. Если знаешь, что скрывается за "т.п." - замени. А если не знаешь - значит совершенно правильно читатель подумает, чистую правду. :)

Этот Тикет уже можно закрыть или продолжим дебаты?

Одно другому не мешает. Можно закрыть тикет и продолжить дебаты... :)

comment:7 by Vladimir, 5 years ago

Resolution: готово
Status: newclosed

Автор платы SW-01 и софта к этой плате всё-таки ты,
т.е. ты всё это придумал и, стало быть, знаешь про эту плату и ПО лучше всех.
Обычно автор изделия или ПО даёт описание, ну или рассказывает про свои творения,
и ты это делаешь в разной форме, а я читаю, слушаю, редактирую,
но обязательно согласовываю тексты с авторами разработок, т.е. с тобой.
Я же не могу разработать описание и руководство того, не знаю чего!
Про "и т.п." я точно не знаю, это я увидел в твоём тексте (см. свой текст Этого тикета),
вот и поинтересовался у тебя: что может скрываться за этими буквами,
но если ты, как истинный автор разработки SW-01 и софта, не знаешь,
то я просто по предложению другого Разработчика (он тоже не знает)
удалю эти буквы и закрою тикет :-)

Итак, вот конечный на сей час результат:

"1.1.2 Преимущества применения ЦСП MC04−DSL:

  • поддержка VLAN Ethernet (IEEE 802.1Q);
  • резервирование плат питания;
  • резервирование центральной платы SW-01 (резервирование функций коммутатора TDM-каналов, управления и мониторинга);
  • возможность организации в одном конструктиве перехода с оптического линейного тракта

на симметричные/коаксиальные медные линии связи с технологией G.SHDSL;

  • поддержка протоколов сетевого управления и мониторинга SNMP, Zabbix;
  • совместимость по протоколам с системами управления и сетевого мониторинга КПО-ОГМ-30 и Zabbix
  • дистанционное питание по одной или двум парам;
  • русскоязычный информативный веб-интерфейс системы программного управления и мониторинга, позволяющей одновременно отслеживать параметры стыков всех устройств в сети связи.

"

in reply to:  7 comment:8 by alx, 5 years ago

Description: modified (diff)

Replying to Vladimir:

Про "и т.п." я точно не знаю, это я увидел в твоём тексте (см. свой текст Этого тикета),
вот и поинтересовался у тебя: что может скрываться за этими буквами,

Извини, не видел, где ты об этом интересовался. В твоих комментариях к этому тикету ты об этом не спрашивал. Вероятно, спрашивал где-то еще, а я, наверное, пропустил...

Как бы то ни было, удовлетворяю твой интерес: под этими буквами могут скрываться функции задающего генератора, мониторинга (агенты SNMP иZabbix), стоечной сигнализации.

но если ты, как истинный автор разработки SW-01 и софта, не знаешь,
то я просто по предложению другого Разработчика (он тоже не знает)
удалю эти буквы и закрою тикет :-)

Во-первых, тикет ты уже закрыл. Довольно странно закрывать тикет, и в то же время грозить сделать это при некоем условии... :)

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

Также обращаю твое внимание на то, что перед перечислением резервируемых функций в описании тикета у меня стоит слово "например". Уже оно должно навести читателя на мысль о том, что далее идет не исчерпывающий перечень функций, а всего лишь пара их примеров. Поэтому "и т.п." в конце фразы особой роли не играет. Давай я сам их удалю - смысл фразы от этого не изменится...

comment:9 by san, 22 months ago

milestone: 1 очередь

Milestone deleted

Note: See TracTickets for help on using tickets.