Opened 8 months ago

Closed 8 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)

in reply to:  description comment:1 by Vladimir, 8 months ago

Resolution: готово
Status: newclosed

Replying to alx:

Предлагаю:

  • заменить слово "вида" в процитированной выше фразе словами "варианта исполнения", и далее использовать "вид" только в значении "внешний вид", и сразу указать эти варианты. Номера исполнений предлагаю уточнить у разработчика платы или в КД.
  • На рисунке 5.100 указать варианты исполнения каждого вида ("вариант исполнения 1", "вариант исполнения 2").
  • Заменить "первый вариант"/"второй вариант" на "вариант исполнения 1"/"вариант исполнения 2".
  • Заменить "новая плата" на указание конкретного варианта исполнения.
  • Добавить в приложение 1 информацию об остальных вариантах исполнения платы RT-01.

В РЭ-59 от 19.09.2023 учтены все предложения.

comment:2 by san, 8 months ago

Resolution: готово
Status: closedreopened

Однако какие именно это варианты исполнения, прямо не говорится, и вообще о них написано очень расплывчато

У платы RT-01 только одно исполнение.

in reply to:  2 ; comment:3 by alx, 8 months ago

Replying to san:

У платы RT-01 только одно исполнение.

Как же одно, если в тексте РЭ, только что проверенном и одобренном разработчиком платы (как написано в комментарии к недавно закрытому тикету, лень искать его номер) прямо говорится о, как минимум, двух вариантах исполнения? Вряд ли разработчик мог одобрить явное вранье о своей разработке...

in reply to:  3 comment:4 by alx, 8 months ago

Replying to alx:

Вряд ли разработчик мог одобрить явное вранье о своей разработке...

Нашел и перечитал комментарий тикета (#401), где говорилось об одобрении разработчиком описания RT-01. Похоже, что я неправильно понял написанное. Сначала я понял так, что в РЭ-58 опубликован уже исправленный и одобренный разработчиком текст описания. Но после повторного (более внимательного) прочтения я понял, что там говорится о том, что разработчик прочитал РЭ-58, после этого внес какие-то исправления и дополнения, и одобрил исправленный им результат (а не то, что было в РЭ-58). Следовательно, одобренный разработчиком результат будет в какой-то из следующих (пока не опубликованных) редакций РЭ. Прошу прощения за то, что по своей невнимательности внес путаницу. :) Будем ждать выхода одобренного разработчиком описания.

Last edited 8 months ago by alx (previous) (diff)

in reply to:  2 comment:5 by Vladimir, 8 months ago

Replying to san:

Однако какие именно это варианты исполнения, прямо не говорится, и вообще о них написано очень расплывчато

У платы RT-01 только одно исполнение.

Вадим сказал, что Исполнение 1 - это первая версия (v1) с двумя 9-контактными разъёмами
(с номером КВ5.236.022, снята с производства).
В варианте исполнения 2 - три двух-контактных разъёма (это v2, v3, v4, и v5) ДТУВ.469435.019.
Это и показано в редактируемом РЭ-59.

comment:6 by san, 8 months ago

Это не исполнения платы, а версии.

comment:7 by san, 8 months ago

Актульная версия RT-01 ДТУВ.469435.019 - v2. Версий 3,4 и 5 у этого изделия не было, может быть имелись в виду версии платы PD-04-RT(составная часть RT-01), разъёмы которой торчат на лицевую.

Думаю что корректно будет сказать, что плата RT-01 выпускалась в двух версиях:
v1 (с двумя 9-контактными разъёмами) - снята с производства
v2 - актуальная версия

comment:8 by alx, 8 months ago

Если у платы нет вариантов исполнения, откуда же, в таком случае, в тексте РЭ взялась информация о том, что есть: "На лицевой панели платы первого варианта исполнения..." ?

comment:9 by san, 8 months ago

Видимо имелась в виду первая версия (v1), просто перепутаны термины.

in reply to:  2 comment:10 by Vladimir, 8 months ago

Resolution: готово
Status: reopenedclosed

Replying to san:

Однако какие именно это варианты исполнения, прямо не говорится, и вообще о них написано очень расплывчато

У платы RT-01 только одно исполнение.

Уточнил: теперь это будет называться так:
"Рис. 5.100 Версии исполнения плат RT–01 с лицевой стороны"
а подписи к версиям такие: Версия v1 (снята с производства) и Версия v2
Соответственно и в тексте будет: "Версия исполнения v1" и "Версия исполнения v2"
В Таблице Приложения-1 в столбце "Номер исполнения" записано "1 (v1)" и "1 (v2)",
т.к. номер исполнения у этих версий одинаковый - "1".

Note: See TracTickets for help on using tickets.