![[MC-04 logo]](/mc-04/chrome/site/logo.png){kind=logo}
#433 closed дефект (готово)
Ошибка в РЭ: неверное указание исполнений платы BS-220
| Reported by: | alx | Owned by: | Vladimir |
|---|---|---|---|
| Priority: | major | Component: | Руководство по эксплуатации |
| Keywords: | Cc: |
Description
В РЭ аппаратуры MC04-DSL-3U редакции 35 на странице 143 написано:
Плата доступна в двух исполнениях:
- BS-220-60...
- BS-220-100...
Также "BS-220-60" и "BS-220-100" несколько раз встречаются ниже.
У платы BS-220 действительно существует два исполнения. Но номера этих исполнений - 1 и 2, а не 60 и 100. Плата BS-220 исполнения 1 имеет мощность 60 Вт, плата BS-220 исполнения 2 имеет мощность 100 Вт. Предполагаю, что в данном случае значения максимальной мощности были перепутаны с номерами исполнений.
Предлагаю скорректировать данный фрагмент следующим образом:
Плата доступна в двух исполнениях:
- исполнение 1 (суммарная выходная мощность для питания блока и заряд аккумулятора 60 Вт);
- исполнение 2 (суммарная выходная мощность для питания блока и заряд аккумулятора 100 Вт).
Кроме этого, при упоминании платы определенного исполнения, чтобы у читателя не возникло путаницы где название платы, а где ее исполнение, явно писать слово "исполнения", например "BS-220 исполнения 2", а не "BS-220-2" (в последнем варианте читателю будет непонятно, является ли свя строка названием платы, или это <Название>-<Исполнение>).
Attachments (2)
Change History (18)
follow-up: 2 comment:1 by , 5 years ago
comment:2 by , 5 years ago
Replying to Vladimir:
BS-220-60... BS-220-100... уже много лет записано во многих источниках информации:
в Каталоге, на Сайте, в прайсах, в презентациях, в разговорах с техподдержкой
(и даже в обучении Крымэнерго на этой неделе были названы именно BS-220-60, BS-220-100).
И? Я не понял, какой вывод должен следовать из твоего комментария... Очень плохо, что уже много лет во многих источниках информации: в Каталоге, на Сайте, в прайсах, в презентациях, в разговорах с техподдержкой (и даже в обучении Крымэнерго на этой неделе) давалась неверная информация. Или ты хочешь сказать, что если так долго вводили людей в заблуждение, то и не надо нарушать эту традицию, и надо дальше продолжать давать неверную информацию?
Исполнение обычно указывается в чертежах РКД и в децимальных номерах изделий,
(кстати, основной вариант исполнения, которое ты называешь 1,
в децимальном номере будет записан, как ....-00,
а Исполнение-2 будет иметь номер ....-01
Это ещё больше будет вносить путаницу, т.к. длинные тексты-пояснения могут и забыть,
И? Не понимаю, к чему ты клонишь. Вывод-то какой? И, главное, какое все это имеет отношение к данному тикету?
"Торговое" название изделия может отличаться.
Опять не понял. Отличаться от чего?
"Исполнение 1", "Исполнение 2"- это абстрактное понятие,
оно ни о чём пользователю не говорит,
Нет, это не абстрактное понятие. Если в документации написано:
Плата BS-220 доступна в двух разных исполнениях:
- исполнение 1 - мощность нагрузки до 60 Вт;
- исполнение 2 - мощность нагрузки до 100 Вт.
то это вполне конкретное, определенное понятие, характеризующее максимально допустимую мощность нагрузки.
поэтому возможны ошибки при заказе,
а вот цифра 60 или 100 сразу указывает на мощность.
Согласен. Это все было бы хорошо, если бы разработчик платы присвоил такие номера исполнений. Но факт в том, что разработчик платы использовал другие номера исполнений - 1 и 2. Это факт, от которого никуда не деться. Вот если бы ты на этапе разработки посоветовал разработчику платы присвоить платам именно эти номера исполнений - все было бы хорошо. Но сейчас - "поздно пить боржими", поезд ушел. Плата имеет исполнения 1 и 2 а не 60 и 100.
АЕН склоняется оставить названия, как в Каталоге, сайте, прайсе,
Какие названия? Еще раз повторяю: название у платы одно - BS-220. В этом тикете речь идет о номерах исполнений платы BS-220.
МВН сказал, что перепечатывать сотни каталогов очень дорого.
А кто предлагал перепечатывать сотни каталогов? В описании данного тикета ни слова не говорится о каталоге. Я предлагаю исправить ошибку в тексте руководства по эксплуатации.
by , 5 years ago
| Attachment: | BS-220-100_пс.doc added |
|---|
follow-up: 8 comment:3 by , 5 years ago
Вывод из моего коммента простой:
информация в РЭ должна быть по возможности понятна
даже с первого взгляда на название платы и если уж это название разошлось
в тысячах экземплярах РЭ, Каталогах, Паспортах, Прайсах, несколько лет на сайте,
то лучше уж так и оставить, иначе будет путаница, когда одно и то же изделие
будет иметь два разных названия, да ещё и не соответствующих РКД,
т.к. в РКД нет "Исполнение-1", "Исполнение-2", а есть децимальные номера:
Плата BS-220-60 КВ5.236.015-02
Питание блока: вход 220В/50 Гц, .... Выходная мощность до 60 Вт.
Плата BS-220-100 КВ5.236.015-03
Питание блока: вход 220В/50 Гц, .... Выходная мощность до 100 Вт.
Текст РЭ должен всё-таки соответствовать давно принятым названиям
в Паспорте, Прайсе, Сайте, к тому же, в Приложении-Д этого РЭ
указаны истинные децимальные номера из РКД и, в частности, в Паспорте.
И ещё 1 довод: наше производство к названию "Плата BS-220"
добавляет металлическую наклейку "-60" или "-100" на лицевой панели платы.
При большом объёме поставок возможно появятся 2 типа лицевых.
Попробуй убедить Неволина, что эти платы надо переобозвать в РЭ
и как теперь их обзывать по-твоему:
"Исполнение-2", "Исполнение-3" ?
Тут же возникнут вопросы: А что такое "Исполнение-1" ?
В РЭ-36 сейчас записано так:
"Плата доступна в двух разновидностях:
- BS-220-60 (суммарная выходная мощность для питания блока и заряд аккумулятора 60 Вт);
- BS-220-100 (суммарная выходная мощность для питания блока и заряд аккумулятора 100 Вт).
"
Можно записать "в двух разновидностях:" - так будет лучше?
comment:4 by , 5 years ago
Можно записать "в двух разновидностях:" - так будет лучше?
Нет, лучше не будет, а внесёт ещё большую путаницу.
Т.к VAU обязательно хочет использовать в тексте "BS-220-60" и "BS-220-100" предлагаю добавить что-то вроде такого описания, вводящего эти обозначения.
Плата BS-220 доступна в двух разных исполнениях: исполнение 1 - мощность нагрузки до 60 Вт; (далее это исполнение платы обозначается как BS-220-60) исполнение 2 - мощность нагрузки до 100 Вт.(далее это исполнение платы обозначается как BS-220-100)
follow-up: 9 comment:6 by , 5 years ago
"Исполнение 1" на самом деле в РКД и в Паспорте записано,
как "Исполнение 2" (КВ5.236.015-02)
а "Исполнение 2" - записано как "Исполнение 3" (КВ5.236.015-03).
Надо ли вносить путаницу с номерами исполнений - это же чисто заводские номера?
Зачем забивать голову пользователей избыточной и не нужной им информации?
Для эксплуатации достаточно и понятно знать 2 исполнения (разновидности):
BS-220-60 (суммарная выходная мощность для питания блока и заряд аккумулятора 60 Вт);
BS-220-100 (суммарная выходная мощность для питания блока и заряд аккумулятора 100 Вт),
а заводской номер исполнений записан в "Приложении Д" данного РЭ
(децимальные номера требуются исключительно для проектных организаций,
для них достаточно "Приложение Д")
follow-up: 10 comment:7 by , 5 years ago
К тому же, на лицевой панели будет записано:
"BS-220-60" или "BS-220-100".
comment:8 by , 5 years ago
Replying to Vladimir:
Попробуй убедить Неволина, что эти платы надо переобозвать в РЭ
??? Зачем я буду убеждать Неволина в том, что не считаю нужным? Плата в РЭ обозвана правильно - "BS-220". Это название соответствует действительности: именно такое название плата сообщает плате SW-01, и, соответственно, именно такое название пользователь видит и в веб-интерфейсе в списках плат блока, и в журнале ("В слоте 20- обнаружена плата BS-220"). Очередной раз повторю: в данном тикете речь не идет об изменении названия платы. В данном тикете речь идет о неверном указании исполнений платы BS-220. У платы BS-220 нет исполнений 60 и 100. У нее есть исполнения 1 и 2.
и как теперь их обзывать по-твоему:
"Исполнение-2", "Исполнение-3" ?
Кого "их"?
Тут же возникнут вопросы: А что такое "Исполнение-1" ?
? Не понял смысл этой фразы. Она должна была навести меня на какую-то мысль? Не навела.
Во-первых, вопросы не возникнут, если в документации (РЭ) будет написано, что это такое. Например так, как предложено в описании тикета:
Плата BS-220 доступна в двух разных исполнениях:
- исполнение 1 (суммарная выходная мощность для питания блока и заряд аккумулятора 60 Вт);
- исполнение 2 (суммарная выходная мощность для питания блока и заряд аккумулятора 100 Вт).
Во-вторых, что с того, что они возникнут? Например, у платы E1-08 тоже есть два исполнения. Пользоветель посмотрит в таблицу в веб-интерфейсе и увидит там "исполнение 2". И что? А у платы EM-04 целых три исполнения. Не возникают вопросы?...
В РЭ-36 сейчас записано так:
"Плата доступна в двух разновидностях:
- BS-220-60 (суммарная выходная мощность для питания блока и заряд аккумулятора 60 Вт);
- BS-220-100 (суммарная выходная мощность для питания блока и заряд аккумулятора 100 Вт).
"
Можно записать "в двух разновидностях:" - так будет лучше?
Насколько я смог уловить различия, слово "исполнениях" заменено на слово "разновидностях". Я не нахожу в этом изменении какого-либо улучшения. Есть четкие понятия "Название платы" и "Исполнение платы. В данном случае плата имеет название "BS-220" и исполнения 1 и 2. В веб-интерфейсе пользователь ясно видит, что вставленная в блок плата называется "BS-220" и имеет исполнение, допустим, 2. Понятие "разновидность" - это какая-то новая сущность, определения которой я нигде не видел, а если нет определения, читатель вынужден гадать, что это означает. Я не вижу
comment:9 by , 5 years ago
Replying to Vladimir:
Надо ли вносить путаницу с номерами исполнений
Нет. Конечно же, путаницу с номерами вносить не надо. Проблема в том, что путаница уже внесена: сама плата считает, что она имеет исполнение 1 и, соответственно, пользователь видит "Исполнение 1" в веб-интерфейсе, а, по твоим словам, в паспорте на эту же плату написано "Исполнение 2".
это же чисто заводские номера?
Что значит "чисто заводские"? Номер исполнения выводится пользователю в веб-интерфейсе (и, возможно, в логах, я точно не помню). Значит это уже не наше внутреннее дело. Если у пользователя есть плата BS-220, то номер ее исполнения должен быть одинаковым и в паспорте, и веб-интерфейсе, и в РЭ. А когда человек купил плату и видит, что в веб-интерфейсе написано, что она имеет исполнение 2, в паспорте - что исполнение 3, а в РЭ - вообще 100, вот тут у него и возникнут вопросы...
Зачем забивать голову пользователей избыточной и не нужной им информации?
??? Если эта информация ненужная и избыточная - удали процитированный в описании тикета фрагмент из текста РЭ. :)
Для эксплуатации достаточно и понятно знать 2 исполнения (разновидности):
BS-220-60 (суммарная выходная мощность для питания блока и заряд аккумулятора 60 Вт);
BS-220-100 (суммарная выходная мощность для питания блока и заряд аккумулятора 100 Вт),
Так в том-то и дело, что здесь номера исполнений указаны неверно! Что такое "-60" и "-100"? Если это номера исполнений платы BS-220, то они неверные: плата BS-220 мощностью 60 Вт имеет исполнение 1, а не 60, а плата BS-110 мощностью 100 Вт имеет исполнение 2, а не 100. В описании тикета я по-моему ясно написал, в чем заключается путаница.
а заводской номер исполнений записан в "Приложении Д" данного РЭ
До приложения Д я РЭ еще не дочитал.
comment:10 by , 5 years ago
Replying to Vladimir:
К тому же, на лицевой панели будет записано:
"BS-220-60" или "BS-220-100".
И что из этого следует? Очень плохо, что так будет написано, больше ничего не могу сказать...
follow-up: 14 comment:12 by , 5 years ago
"К тому же, на лицевой панели будет записано:
"BS-220-60" или "BS-220-100".
Алекс: "И что из этого следует? Очень плохо, что так будет написано"
Если на лицевой не будет отличий, то тогда эти платы будут путать
про заказе и при установке в блок, а эти платы невзаимозаменяемые...
А хорошо ли это?
Алекс: "Кстати, я посмотрел паспорта и не нашел в них слова "исполнение".
Разработчик Паспортов Вадим и наше Производство, видимо,
считают, что "BS-220-60" и "BS-220-100" - это две разные платы.
Кстати, описание этих плат я скопирован у Неволина.
comment:13 by , 5 years ago
Я немного изучил формат децимальных номеров, указываемыз в РКД. Я пришел к выводу, что номер исполнения, который имеют платы в аппатаруре MC04-DSL-3U и номер исполнения, указываемый в децимальном номере, не могут полностью совпадать.
Так, номер исполнения платы может принимать значения от 0 до 255, в то время как номер исполнения в децимальном номере может принимать значения от 1 до 98. Зато в децимальном номере может присутствовать некий дополнительный номер исполнения от 1 до 99, что вместе с номером исполнения дает 9702 возможные комбинации, которые непредставимы платами.
Поэтому я не вижу криминала в том, что нормер исполнения в децимальном номере не совпадает с номером исполнения, отображаемым в веб-интерфейсе. Однако я согласен с тем, что если такая возможность есть, имеет смысл делать одинаковые номера исполнений в децимальным номере и в веб-интерфейсе. Просто я, например, не знал, что децимальные номера плат попадают конечному потребителю. Я думал, это наше внутреннее дело... :) Учту это для будущих разработок.
comment:14 by , 5 years ago
Replying to Vladimir:
Алекс: "И что из этого следует? Очень плохо, что так будет написано"
Если на лицевой не будет отличий, то тогда эти платы будут путать
про заказе и при установке в блок, а эти платы невзаимозаменяемые...
А хорошо ли это?
Нет, не хорошо, а, скорее, наоборот, очень плохо, что платы будут путать.
Но твою логику я нахожу крайне странной. По-твоему получается такая альтернатива: либо надписи на планках обоих исполнений плат одинаковые, не различаются ничем, либо на планках написаны два разных неверных исполнения платы - 60 и 100. Но позвольте, а почему только такие два варианта? Почему на планке нельзя написать номера исполнений, которые платы имеют на самом деле - "BS-220-1" и "BS-220-2"? А еще лучше будет, если указать номер исполнения отдельной строкой - "исп. 1" и "исп. 2" - это исключит возможность ошибочно подумать, что "BS-220-1" и "BS-220-2" - это две разные платы, а не два разных исполнения одной и той же платы BS-220. Собственно, это я зачем-то очередной раз повторил то, что написано в описании тикета...
Разработчик Паспортов Вадим и наше Производство, видимо,
считают, что "BS-220-60" и "BS-220-100" - это две разные платы.
Вот! Это именно то, о чем говорится в описании тикета. Чтобы избежать этой путаницы, надо более четко отделять название платы от ее исполнения.
comment:15 by , 5 years ago
| Resolution: | → готово |
|---|---|
| Status: | new → closed |
АЕН согласился внести изменения в РКД и исправить децимальные номера исполнений
с "-02", "-03" на "-01", "-02" и кроме того, дал задание Вадиму сделать для этих
исполнений наклейки на лицевой панели: "60W", "100W".
Текст в РЭ АЕН одобрил в редакции Саши:
Плата доступна в двух исполнениях:
- исполнение 1 - суммарная мощность нагрузки до 60 Вт (далее обозначается как BS-220-60);
- исполнение 2 - суммарная мощность нагрузки до 100 Вт (далее обозначается как BS-220-100).
Теперь названия типа BS-220-60, BS-220-100 будут соответствовать всем Каталогам,
на Сайте, в Паспортах, в Таблицах, в Прайсах.
Хотя я бы лучше исправил прошивку платы, чтобы на вкладке "Обновление ПО"
в колонке "Исполнение платы" была бы запись, как на вкладке "Плата BS-220 слот 20",
т.е."Исполнение платы:" "60 Вт" или "100 Вт".
BS-220-60... BS-220-100... уже много лет записано во многих источниках информации:
в Каталоге, на Сайте, в прайсах, в презентациях, в разговорах с техподдержкой
(и даже в обучении Крымэнерго на этой неделе были названы именно BS-220-60, BS-220-100).
Исполнение обычно указывается в чертежах РКД и в децимальных номерах изделий,
(кстати, основной вариант исполнения, которое ты называешь 1,
в децимальном номере будет записан, как ....-00,
а Исполнение-2 будет иметь номер ....-01
Это ещё больше будет вносить путаницу, т.к. длинные тексты-пояснения могут и забыть,
"Торговое" название изделия может отличаться.
"Исполнение 1", "Исполнение 2"- это абстрактное понятие,
оно ни о чём пользователю не говорит, поэтому возможны ошибки при заказе,
а вот цифра 60 или 100 сразу указывает на мощность.
АЕН склоняется оставить названия, как в Каталоге, сайте, прайсе,
МВН сказал, что перепечатывать сотни каталогов очень дорого.