#698 closed дефект (готово)
РЭ: графа состояния регенераторов State описана дважды
Reported by: | alx | Owned by: | Vladimir |
---|---|---|---|
Priority: | major | Component: | Руководство по эксплуатации |
Keywords: | Cc: | ledol |
Description
В РЭ аппаратуры MC04-DSL-3U редакции 42 в таблице 8.7 на странице 307 графа State описана дважды, причем одно описание противоречит другому.
Предлагаю исключить из таблицы одно из описаний графы State (желательно неправильное).
Change History (24)
follow-up: 2 comment:1 by , 4 years ago
comment:2 by , 4 years ago
Cc: | added |
---|
Replying to Vladimir:
А ты не можешь подсказать, какое описание State правильное?
Нет.
"3" - а это что такое, кто знает?
Думаю, это знает разработчик платы.
follow-up: 4 comment:3 by , 4 years ago
В Табл.5.13 про SM записано так:
"0 – интерфейс DSL выключен;
1 – активация интерфейса DSL;
2 – интерфейс DSL в рабочем состоянии;
3 – нет сигнала СЦС."
Тогда в в таблице 8.7 записать точно так же?
А для Е1-08:
"| State | 0 – авария интерфейса или интерфейс заблокирован; 1 – нет аварий.|"
Этого достаточно?
follow-up: 9 comment:4 by , 4 years ago
Replying to Vladimir:
В Табл.5.13 про SM записано так:
"0 – интерфейс DSL выключен;
1 – активация интерфейса DSL;
2 – интерфейс DSL в рабочем состоянии;
3 – нет сигнала СЦС."
Тогда в в таблице 8.7 записать точно так же?
Записать надо правильно, то есть так, как на самом деле. Если то, что написано в таблице 5.13, соответствует действительности - то да, можно записать точно так же. Если не соответствует - то нет, точно так же записывать не надо, надо изменить записанное и в таблице 5.13, и в таблице 8.7 на правильное.
А для Е1-08:
"| State | 0 – авария интерфейса или интерфейс заблокирован; 1 – нет аварий.|"
Этого достаточно?
Достаточно ли этого для чего?
follow-ups: 6 11 comment:5 by , 4 years ago
Причина дублирования мне понятна: раньше в таблице состояния регенераторов был ещё один столбец state, относящийся к целому устройству, а не к интерфейсу, затем его убрали как бесполезный.
А для Е1-08:
Причём здесь E1-08 ? Тикет о платах SM
Хм, я только что заметил, что таблица 8.7 это полная копия таблицы 5.13. не считая ошибок...
А давайте оставим только одну таблицу 5.13, а в п.8.6 сделаем ссылку на неё.
(как вы знаете я ярый борец с дублированием информации, и этот тикет в очередной раз иллюстрирует почему - в одном месте в таблице исправили, а в другой копии осталось... и вот всё у нас так)
comment:6 by , 4 years ago
Replying to san:
А давайте оставим только одну таблицу 5.13, а в п.8.6 сделаем ссылку на неё.
Я с некоторых пор перестал предлагать устранить дублирования. Практически все подобные предложения встречают контр-аргументы (формально верные!) редактора РЭ:
- повторение - мать учения, так читатель лучше запомнит;
- информацию быстрее найти, если несколько копий рассредоточены по тексту РЭ;
- забота о читателе - чтобы ему не приходилось кликать по ссылке, а информация сразу была перед глазами.
А раз заведомо известно, что принимающий решения - против, то зачем предлагать?
follow-ups: 8 12 comment:7 by , 4 years ago
Аргументы верные, в том случае, если автор будет держать под контролем информацию во всех дублях. Однако практика показывает обратное)
И раз уж Vladimir часто взывает ко мне как к "ответственному", перекладывая решения на меня) воспользуюсь положением и буду продолжать борьбу с дублированием.
follow-up: 13 comment:8 by , 4 years ago
Replying to san:
Аргументы верные, в том случае, если автор будет держать под контролем информацию во всех дублях. Однако практика показывает обратное)
Не могу согласиться. Верность аргументов Владимира никак не зависит от "держания информации под контролем", это две разные задачи (проблемы). Обрати внимание, что даже без дублирования у нас изменения в текст РЭ вносится в среднем спустя два года после выпуска соответствующих изменений в аппаратуре.
И раз уж Vladimir часто взывает ко мне как к "ответственному", перекладывая решения на меня) воспользуюсь положением и буду продолжать борьбу с дублированием.
Удачи, товарищ! :)
follow-up: 10 comment:9 by , 4 years ago
Replying to alx:
Replying to Vladimir:
В Табл.5.13 про SM записано так:
"0 – интерфейс DSL выключен;
1 – активация интерфейса DSL;
2 – интерфейс DSL в рабочем состоянии;
3 – нет сигнала СЦС."
Тогда в в таблице 8.7 записать точно так же?
Записать надо правильно, то есть так, как на самом деле.
Я не могу точно знать как правильно, на самом деле:
это я не придумывал, ни разрабатывал, ни проверял, ни испытывал, ни настраивал...
Если ты или кто-то скажет/напишет мне, как правильно и на самом деле,
тогда и я буду знать :-)
Пишите, рассказывайте как сделали и тогда я вставлю правильный текст.
А для Е1-08:
"| State | 0 – авария интерфейса или интерфейс заблокирован; 1 – нет аварий.|"
Этого достаточно?
Достаточно ли этого для чего?
Чтобы это было как на самом деле:
не надо ли добавить, например, аварию ЦС, СЦС или ещё чего-нибудь?
comment:10 by , 4 years ago
Replying to Vladimir:
Я не могу точно знать как правильно, на самом деле:
это я не придумывал, ни разрабатывал, ни проверял, ни испытывал, ни настраивал...
Господь сказал: кто дал уста человеку? кто делает немым, или глухим, или зрячим, или слепым? не Я ли Господь? итак пойди, и Я буду при устах твоих и научу тебя, что тебе говорить.
(Исх.4:11,12)
Это был намек. :)
На всякий случай еще один намек: когда я чего-то не знаю, я спрашиваю того, кто знает. :)
Ладно, не буду заставлять тебя разгадывать намеки. :) Рекомендую спросить, как правильно, у разработчика платы.
Если ты или кто-то скажет/напишет мне, как правильно и на самом деле,
тогда и я буду знать :-)
Браво! :)
Пишите, рассказывайте как сделали и тогда я вставлю правильный текст.
Я тоже не могу точно знать как правильно, на самом деле:
это я тоже не придумывал, не разрабатывал, не проверял, не испытывал.
Достаточно ли этого для чего?
Чтобы это было как на самом деле:
не надо ли добавить, например, аварию ЦС, СЦС или ещё чего-нибудь?
Этого я не знаю. Я это не придумывал, не разрабатывал, не проверял, не испытывал. Рекомендую задать этот вопрос тому, кто это придумывал.
comment:11 by , 4 years ago
Replying to san:
Хм, я только что заметил, что таблица 8.7 это полная копия таблицы 5.13. не считая ошибок...
Это произошло после того, как МВН и АЕН решили внести отдельное когда-то РЭ на РЛ
в РЭ на МС04-DSL-3U, а до этого между МВН и АЕН был спор:
АЕН хотел несколько отдельных РЭ
МВН хотел одно общее РЭ
и приняли компромиссное решение: пусть будет общее РЭ,
но так, чтобы его можно было распечатать на отдельные разделы,
а это стало приводить к дублированию некоторых видов информации.
А давайте оставим только одну таблицу 5.13, а в п.8.7 сделаем ссылку на неё.
(как вы знаете я ярый борец с дублированием информации, и этот тикет в очередной раз иллюстрирует почему - в одном месте в таблице исправили, а в другой копии осталось... и вот всё у нас так)
Сейчас я делаю поиск не по номерам страниц, рисунков, таблиц, а по ключевым словам,
поэтому мне и попалась плата Е1-08 по слову "State" и я увидел разницу между не только
между таблицами 5.13, и 8.7, но и в Табл. 5.27 Назначение колонок в таблице Статистика Е1
и возник вопрос: не пропущены ли там некоторые состояния.
comment:12 by , 4 years ago
Replying to san:
Аргументы верные, в том случае, если автор будет держать под контролем информацию во всех дублях. Однако практика показывает обратное)
И раз уж Vladimir часто взывает ко мне как к "ответственному", перекладывая решения на меня) воспользуюсь положением и буду продолжать борьбу с дублированием.
Т.е. надо обязательно убрать Табл.8.7 ?
А может быть, посоветоваться, например, с АЕН - это он вставил Таблицу типа 8.7
в своё РЭ на регенераторы и хотел сохранить целостность текста в новом РЭ.
Убрать не долго, но при работе с регенераторами будет неудобство, особенно для бумажных РЭ
и полноценную книжечку для РЛ уже будет труднее распечатать...
follow-up: 14 comment:13 by , 4 years ago
Не могу согласиться.
Ну это я выразился не точно.
Я имел в виду, что в существующих реалиях, дублирование информации усугубляет наши проблемы с РЭ.
comment:14 by , 4 years ago
Replying to san:
Не могу согласиться.
Ну это я выразился не точно.
Я имел в виду, что в существующих реалиях, дублирование информации усугубляет наши проблемы с РЭ.
Т.е. п.8.7 удалить? Да или Нет? :-)
follow-ups: 16 17 comment:15 by , 4 years ago
Удалять п.8.7 я не предлагал, я предлагал вместо таблицы 8.7. вставить ссылку на оригинал(таблицу 5.13)
comment:16 by , 4 years ago
Replying to 'san:
Удалять п.8.7 я не предлагал, я предлагал вместо таблицы 8.7. вставить ссылку на оригинал(таблицу 5.13)
Ссылка на 5.13 это само-собой разумеется, если удалить табл.8.7.
А тебе самому было бы удобно в бумажном РЭ смотреть на
Рис. 8.12 Вкладка Состояние регенераторов DSL A, DSL B на стр.306
а описание каждого из 18 параметров искать на стр.36 в Табл.5.13?
Для меня и для многих это кошмар...
(особенно, если кто-то распечатает отдельно раздел 8 про регенераторы).
Но если ты настаиваешь на неудобстве для юзеров,
то я вынужден буду вместо табл.8.7 на стр.306
поставить ссылку на Табл.5.13 на стр.36.
Ну, так заменить Табл.8.7 на ссылку на Табл.5.13?
Да или Нет ?
А давай я или ты спросишь про это АЕН - он же поручил мне редактировать РЭ...
follow-up: 19 comment:17 by , 4 years ago
Replying to san:
Удалять п.8.7 я не предлагал, я предлагал вместо таблицы 8.7. вставить ссылку на оригинал(таблицу 5.13)
В этом Тикете-698 про таблицу 5.13 не было ни слова...
Что касается повторения строки "State", то неправильную в РЭ-43 я уже удалил,
и теперь в Табл.8.7 между строками MAST и Rate записано так:
"State
0 – интерфейс DSL выключен;
1 – активация интерфейса DSL;
2 – интерфейс DSL в рабочем состоянии.
3 – нет сигнала СЦС."
Если Табл.8.7 несмотря ни на что надо категорически удалить
и вместо Табл.8.7 поставить ссылку на почти 300 страниц выше (на таблицу 5.13),
то выпусти новый тикет про это (хотя мне это кажется крайне неудобным для юзеров,
но я выполню это, но вряд ли это понравится АЕН).
comment:18 by , 4 years ago
Resolution: | → готово |
---|---|
Status: | new → closed |
В РЭ-43 в таблице 8.7 на странице 307 лишнюю графу State удалил.
follow-up: 20 comment:19 by , 4 years ago
follow-up: 21 comment:20 by , 4 years ago
Replying to alx:
Replying to Vladimir:
В этом Тикете-698 про таблицу 5.13 не было ни слова...
Я имел ввиду Текст Тикета-698:
"РЭ: графа состояния регенераторов State описана дважды
Описание
В РЭ аппаратуры MC04-DSL-3U редакции 42 в таблице 8.7 на странице 307
графа State описана дважды, причем одно описание противоречит другому.
Предлагаю исключить из таблицы одно из описаний графы State (желательно неправильное)."
Именно это я и сделал, и закрыл Тикет
В comment:3 этого тикета написано: "В Табл.5.13 про SM записано так...".
В Комменте-5 было так: -"А давайте оставим только одну таблицу 5.13",
т.е. это призыв к обсуждению этого нового вопроса не по теме Данного Тикета-698, а если кто-то считает, что это категорически надо сделать, то пусть он выпустит про это новый Тикет, т.к. мне это предложение кажется крайне неудобным для юзеров
(листать почти 300 страниц туда-сюда 18 раз, да даже и на ПК прыгать 18 раз туда-сюда неудобно).
Вот тебе, Алекс, понравилось бы листать 300 бумажных страниц 18 раз? :-)
Если будет новый тикет про Табл.5.13, то я сначала посоветуюсь с тем, кто поручил мне редактировать РЭ и даже велел вставить своё бывшее РЭ на регенераторы в Это РЭ
(поэтому раздел "8 ЛИНЕЙНЫЕ РЕГЕНЕРАТОРЫ ЦСП MC04-DSL" в самом конце РЭ).
follow-up: 23 comment:21 by , 4 years ago
comment:22 by , 4 years ago
Саша поговорил с АЕН и пришли к выводу, что рисунок окна и таблицу
надо разместить рядом на стр.35-36, а на стр.306 дать ссылку на Рис. и Табл.,
тогда не надо будет листать 300 страниц 18 раз, а только 1 раз.
Так и сделаю, Саша обещал прислать правильный рисунок для стр. 35.
comment:23 by , 4 years ago
Replying to alx:
Replying to Vladimir:
Вот тебе, Алекс, понравилось бы листать 300 бумажных страниц 18 раз? :-)
Нет.
Саша поговорил с АЕН и пришли к выводу, что рисунок окна и таблицу
надо разместить рядом на стр.35-36, а на стр.306 дать ссылку на Рис. и Табл.,
тогда не надо будет листать 300 страниц 18 раз, а только 1 раз.
Так и сделаю, Саша обещал прислать правильный рисунок для стр. 35.
А ты не можешь подсказать, какое описание State правильное?
Кроме того, на Рис."Вкладка Состояние регенераторов DSL A, DSL B"
обозначения в графе State совсем другие:
"ОК(2)"
"Выкл(0)"
"3" - а это что такое, кто знает? В Таблице 8.7 этого состояния нет...