#380 closed улучшение (готово)
РЭ: одинаковое обозначение разных пар
Reported by: | alx | Owned by: | Vladimir |
---|---|---|---|
Priority: | major | Component: | Руководство по эксплуатации |
Keywords: | Cc: |
Description
В РЭ аппаратуры MC04-DSL-3U на странице 104 говорится о двух парах контактов датчиков и о двух парах выходных контактов. Таким образом, всего существует 4 разные пары контактов, что видно в таблице 5.79. Но вот обозначены пары почему-то только "Пара 1" и "Пара 2"! Из-за этого когда, например, в таблице 5.80 говорится об активном состоянии пары 1, непонятно, о какой именно паре 1 идет речь: о входе (контакты 1, 2) или выходе (контакты 5, 6).
Предлагаю для исключения неоднозначного толкования текста РЭ обозначить все 4 пары по-разному.
Change History (6)
follow-up: 2 comment:1 by , 6 years ago
comment:2 by , 6 years ago
Replying to Vladimir:
Это обозначение возникло от тебя, когда ты разрабатывал вкладку "Модуль 2: СS02"
(см. рис.5.72): показано всего 2 канала, но в назначении графы "Канал (Табл.5.81)"
записано: "Номер пары входных/выходных контактов",
т.е. номер канала соответствует номеру пары, но для каждого канала по 2 пары,
обозначенные
Пара 1, входы, на рис. это с1in
Пара 2, входы, на рис. это с2in
Пара 1, выходы, на рис. это с1out
Пара 2, выходы, на рис. это с2out
Во-первых, не вкладку, а диалог конфигурации модуля. Вкладки - это такие "листы" сложенные "стопкой" друг на друга, между которыми можно переключаться, кликая по их "ярлычкам" - см. например вкладки "Платы", "Журнал", "Ethernet" и т.п.
Во-вторых, там (в веб-интерфейсе) нет обозначений "Пара 1" и "Пара 2".
В-третьих, делая веб-интерфейс, я представления не имел, сколько там пар, есть ли она там вообще, и вообще я не знал, что этот модуль делает. Я просто следовал указаниям разработчика платы.
В-четвертых, таблицу 5.81 писал не я, я ее сегодня первый раз в жизни увидел.
В-пятых, а почему ты вообще об этом написал? Какое имеет значение, от кого возникло обозначение? По-моему значение имеет то, что прочитав в таблице 5.80 "Пара 1, активное состояние", непонятно, о состоянии какой пары идет речь...
follow-up: 4 comment:3 by , 6 years ago
Я просто предположил, что с тобой, как с соучастником этой разработки,
всё это было согласовано, поэтому "имеет значение" спросить у того,
с кем согласовано и кто больше знаком с этим вопросом и больше знает про это:
я же не могу знать, что именно ты знаешь, а чего не знаешь :-)
Но твой ответ не конструктивный: нет конкретного предложения
по описанию ячеек таблицы на Рис.5.72 и, в частности, по обозначению
пар проводов в соответствии с твоим, по сути, рисунком.
Если есть идея и ты знаешь, как лучше и понятнее - то предложи для обсуждения.
Кстати, слово "вкладка" в данном РЭ встречается 170 раз,
а слово "диалог...." только 10 раз - "вкладка" в 17 раз популярнее :-)
А "диалог конфигурации" где находится - на вкладке, на закладке, на подвкладке?
comment:4 by , 6 years ago
Replying to Vladimir:
Я просто предположил, что с тобой, как с соучастником этой разработки,
всё это было согласовано, поэтому "имеет значение" спросить у того,
с кем согласовано и кто больше знаком с этим вопросом и больше знает про это:
я же не могу знать, что именно ты знаешь, а чего не знаешь :-)
Почему же не спросил? :) Я не вижу в comment:1 никакого вопроса...
Но твой ответ не конструктивный: нет конкретного предложения
по описанию ячеек таблицы на Рис.5.72 и, в частности, по обозначению
пар проводов в соответствии с твоим, по сути, рисунком.
Не понимаю, какое отношение рисунок 5.72 имеет к обозначению пар интерфейса платы. На этом рисунке никакие пары вообще не упоминаются...
Тикет в целом был бы неконструктивным, если бы я ограничился констатацией факта, что непонятно, о какой именно паре идет речь в таблице 5.80, и ничего не предложил для улучшения. Но предложение по улучшению есть в описании тикета, поэтому тикет в целом конструктивный. Повторять уже написанное предложение в каждом новом комментарии мне не казалось необходимым.
Если есть идея и ты знаешь, как лучше и понятнее - то предложи для обсуждения.
Идея, как сделать лучше и понятнее, изложена в описании тикета. Повторю: предлагаю для исключения неоднозначного толкования текста РЭ обозначить все 4 пары по-разному. Предлагаю предложенное мной улучшение для обсуждения. :)
Так как, судя по объему дискуссии, предложенное улучшение оказалось не очень понятным, попробую, не дожидаясь вопросов, дать пояснение. Если дать каждой паре уникальное обозначение, например "Пара 1", "Пара 2", "Пара 3" и "Пара 4", то когда в таблице 5.80 будет написано об активном состоянии "Пары 1", у читателя не будет возникать вопрос, о какой именно из двух имеющихся "Пар 1" идет речь. Таким образом, неоднозначность устранится, и проблема будет решена.
Кстати, слово "вкладка" в данном РЭ встречается 170 раз,
а слово "диалог...." только 10 раз - "вкладка" в 17 раз популярнее :-)
Спасибо за интересную статистику. :) Я специально не проверял, но рискну предположить, что слово "и" намного популярнее слов "диалог" и "вкладка" вместе взятых. :)
А "диалог конфигурации" где находится - на вкладке, на закладке, на подвкладке?
Нигде из перечисленного. Диалоги помещаются "поверх" всего, что уже есть на странице, перекрывая собой имеющийся контент. При этом непосредственно "под" диалогом (но тоже поверх всего что уже было на странице), помещается полупрозрачный фон, затемняющий все, что было под диалогом. Более того, пользователь может свободно перемещать диалог за его заголовок в пределах документа в окне браузера. Таким образом, у диалогов нет какого-либо определенного положения в веб-интерфейсе (на странице), они "вне" его структуры. Еще могу сказать, что первоначально (в момент появления) диалог позиционируется на странице чуть выше центра экрана.
comment:5 by , 6 years ago
Resolution: | → готово |
---|---|
Status: | new → closed |
В РЭ-36 исправил названия назначений контактов в Табл.5.79 и 5.80
в соответствии с Рис.5.72:
Канал 1, вход c1in
Канал 2, вход c2in
Канал 1, выходы c1out
Канал 2, выходы c2out
Это обозначение возникло от тебя, когда ты разрабатывал вкладку "Модуль 2: СS02"
(см. рис.5.72): показано всего 2 канала, но в назначении графы "Канал (Табл.5.81)"
записано: "Номер пары входных/выходных контактов",
т.е. номер канала соответствует номеру пары, но для каждого канала по 2 пары,
обозначенные
Пара 1, входы, на рис. это с1in
Пара 2, входы, на рис. это с2in
Пара 1, выходы, на рис. это с1out
Пара 2, выходы, на рис. это с2out