Opened 14 months ago
Closed 14 months ago
#1234 closed улучшение (готово)
РЭ: нет информации о вариантах исполнения платы RT-01
Reported by: | alx | Owned by: | Vladimir |
---|---|---|---|
Priority: | major | Component: | Руководство по эксплуатации |
Keywords: | Cc: |
Description
В РЭ аппаратуры MC04-DSL-3U редакции 58 в описании платы RT-01 в разделе 5.21 говорится о существовании нескольких вариантов исполнения этой платы (например ни рисунке 5.100 изображены лицевые панели двух вариантов исполнения). Однако какие именно это варианты исполнения, прямо не говорится, и вообще о них написано очень расплывчато. Например:
- В тексте написано: "На Рис. 5.100 приведены два вида платы RT–01...". У читателя сразу возникнет опрос: а что такое "вид платы"? Есть понятия "тип платы", "наименование платы", "вариант исполнения платы"... а "вид платы" - это что-то новое... И только из последующего текста можно понять, что имелись в виду варианты исполнения...
- В тексте упоминаются словосочетания "первого варианта исполнения", "второго варианта исполнения". И опять непонятно, что имеется в виду: первый/второй из двух имеющихся, но почему-то не названных, вариантов исполнения, или конкретно "вариант исполнения 1" и "вариант исполнения 2"?
- В тексте написано: "Новая плата: на лицевой панели...". У читателя немедленно возникнет вопрос: что значит "новая"? А есть, значит, еще и "старая"? Почему же о старой в РЭ ничего не написано? Или может быть лицевая панель будет меняться по мере старения платы, как меняется лицо человека? :)
- В таблице 13.1 приложения 1, где (должны быть по идее) перечислены все платы и их варианты исполнения, у платы RT-01 указан только один вариант исполнения - 1, что только добавляет путаницу (а в каталоге платы RT-01 вообще нет, но это уже не имеет отношения к РЭ)...
Исходя из названий разъемов, я догадываюсь, что под словами "новая плата" имеется в виду вариант исполнения 2, лицевая панель которого изображена с правой стороны на рисунке 5.100...
Зачем же заставлять читателя гадать о том, что имеется в виду, используя три разных термина для обозначения одного и того же? Мне кажется, будет лучше и понятнее, если использовать один термин - "вариант исполнения".
Предлагаю:
- заменить слово "вида" в процитированной выше фразе словами "варианта исполнения", и далее использовать "вид" только в значении "внешний вид", и сразу указать эти варианты. Номера исполнений предлагаю уточнить у разработчика платы или в КД.
- На рисунке 5.100 указать варианты исполнения каждого вида ("вариант исполнения 1", "вариант исполнения 2").
- Заменить "первый вариант"/"второй вариант" на "вариант исполнения 1"/"вариант исполнения 2".
- Заменить "новая плата" на указание конкретного варианта исполнения.
- Добавить в приложение 1 информацию об остальных вариантах исполнения платы RT-01.
На всякий случай уточняю, что перечисленные предложения не взаимоисключающие - я не предлагаю выполнить одно из перечисленных предложений на выбор, я предлагаю выполнить их все.
Change History (10)
comment:1 by , 14 months ago
Resolution: | → готово |
---|---|
Status: | new → closed |
follow-ups: 3 5 10 comment:2 by , 14 months ago
Resolution: | готово |
---|---|
Status: | closed → reopened |
Однако какие именно это варианты исполнения, прямо не говорится, и вообще о них написано очень расплывчато
У платы RT-01 только одно исполнение.
follow-up: 4 comment:3 by , 14 months ago
Replying to san:
У платы RT-01 только одно исполнение.
Как же одно, если в тексте РЭ, только что проверенном и одобренном разработчиком платы (как написано в комментарии к недавно закрытому тикету, лень искать его номер) прямо говорится о, как минимум, двух вариантах исполнения? Вряд ли разработчик мог одобрить явное вранье о своей разработке...
comment:4 by , 14 months ago
Replying to alx:
Вряд ли разработчик мог одобрить явное вранье о своей разработке...
Нашел и перечитал комментарий тикета (#401), где говорилось об одобрении разработчиком описания RT-01. Похоже, что я неправильно понял написанное. Сначала я понял так, что в РЭ-58 опубликован уже исправленный и одобренный разработчиком текст описания. Но после повторного (более внимательного) прочтения я понял, что там говорится о том, что разработчик прочитал РЭ-58, после этого внес какие-то исправления и дополнения, и одобрил исправленный им результат (а не то, что было в РЭ-58). Следовательно, одобренный разработчиком результат будет в какой-то из следующих (пока не опубликованных) редакций РЭ. Прошу прощения за то, что по своей невнимательности внес путаницу. :) Будем ждать выхода одобренного разработчиком описания.
comment:5 by , 14 months ago
Replying to san:
Однако какие именно это варианты исполнения, прямо не говорится, и вообще о них написано очень расплывчато
У платы RT-01 только одно исполнение.
Вадим сказал, что Исполнение 1 - это первая версия (v1) с двумя 9-контактными разъёмами
(с номером КВ5.236.022, снята с производства).
В варианте исполнения 2 - три двух-контактных разъёма (это v2, v3, v4, и v5) ДТУВ.469435.019.
Это и показано в редактируемом РЭ-59.
comment:7 by , 14 months ago
Актульная версия RT-01 ДТУВ.469435.019 - v2. Версий 3,4 и 5 у этого изделия не было, может быть имелись в виду версии платы PD-04-RT(составная часть RT-01), разъёмы которой торчат на лицевую.
Думаю что корректно будет сказать, что плата RT-01 выпускалась в двух версиях:
v1 (с двумя 9-контактными разъёмами) - снята с производства
v2 - актуальная версия
comment:8 by , 14 months ago
Если у платы нет вариантов исполнения, откуда же, в таком случае, в тексте РЭ взялась информация о том, что есть: "На лицевой панели платы первого варианта исполнения..." ?
comment:10 by , 14 months ago
Resolution: | → готово |
---|---|
Status: | reopened → closed |
Replying to san:
Однако какие именно это варианты исполнения, прямо не говорится, и вообще о них написано очень расплывчато
У платы RT-01 только одно исполнение.
Уточнил: теперь это будет называться так:
"Рис. 5.100 Версии исполнения плат RT–01 с лицевой стороны"
а подписи к версиям такие: Версия v1 (снята с производства) и Версия v2
Соответственно и в тексте будет: "Версия исполнения v1" и "Версия исполнения v2"
В Таблице Приложения-1 в столбце "Номер исполнения" записано "1 (v1)" и "1 (v2)",
т.к. номер исполнения у этих версий одинаковый - "1".
Replying to alx:
В РЭ-59 от 19.09.2023 учтены все предложения.