Opened 7 years ago

Closed 4 months ago

#146 closed улучшение (готово)

Добавить в РЭ описание полной конфигурации Ethernet

Reported by: alx Owned by: Vladimir
Priority: trivial Component: Руководство по эксплуатации
Keywords: Cc:

Description (last modified by Vladimir)

alx:

Мы (разработчики блока 3U) не принимали решения, что полный вариант интерфейса не надо описывать вообще никогда, мы просто договорились, что описание функций, которые доступны только в нем (в виду не очень частого использования), отложим в "долгий ящик" на неопределенное "потом", так как есть много других более приоритетных задач по РЭ (например исправление имеющихся в нем ошибок).
Все, что есть в веб-интерфейсе, должно быть описано в документации, иначе пользователь не сможет этим пользоваться (так как не будет знать как).


san:
Создал wiki/Ethernet для описания полной конфигурации Ethernet, добавил туда описание колонки Pause, предлагаю по возможности добавлять на эту страничку описание настроек полной конфигурации ethernet и когда-нибудь добавить это всё в РЭ.

Change History (130)

comment:1 by san, 6 years ago

milestone: Текущие работы2 очередь

Milestone renamed

comment:2 by san, 6 years ago

Summary: Добавить в руководствоДобавить в РЭ ethernet->Порты-> "Pause"

comment:3 by san, 6 years ago

Owner: changed from andrei to Vladimir
Status: newassigned

comment:4 by Vladimir, 4 years ago

В РЭ-41 в пункте "5.14.6 Вкладка "Ethernet" есть колонка "Pause",
но нет "Возможные состояния ячеек в этой колонке", а только чекбокс для галочки.

comment:5 by san, 4 years ago

А при чём здесь п.5.14.6 ? Он к тикету не относится.

in reply to:  2 ; comment:6 by Vladimir, 2 years ago

Replying to san:
В Демо открыл окно ethernet->Порты, но "Pause" там не увидел
В РЭ-51 есть вкладка:
6.2.3 Вкладка Ethernet - настройка коммутатора платы SW-01
и Рис.6.8 и тут тоже нет "Pause".
"Pause" есть в "5.14.6 Вкладка "Ethernet" (платы ST) "Рис. 5.62 Вкладка "Ethernet"
и есть в "5.4.3 Настройка платы TD-01", "Рис. 5.23 Вкладка Ethernet платы TD-01"

В какое место надо добавить "Pause"?

in reply to:  6 comment:7 by alx, 2 years ago

Resolution: invalid
Status: assignedclosed

Replying to Vladimir:

В Демо открыл окно ethernet->Порты, но "Pause" там не увидел

В описании тикета есть важное уточнение - "полной конфигурации ethernet". В полной конфигурации ethernet в "Демо доступе" колонка "Pause" есть. Однако я забыл, что полный вариант конфигурации ethernet мы договорились пока (временно) не описывать. Поэтому тикет был создан по ошибке.

in reply to:  description ; comment:8 by Vladimir, 2 years ago

Replying to alx:

Начиная с sw:r1599 в веб-интерфейсе блока MC04-DSL-3U в таблице "Порты" полной конфигурации ethernet добавлена колонка "Pause", отображающая состояние приема/передачи кадров Pause. Возможные состояния ячеек в этой колонке:

В обычной (краткой) конфигурации я не нашёл слово "Pause"
(упустил из вида слово "в таблице "Порты" полной конфигурации ethernet".
САН подсказал, что надо зайти в "Разное" и выбрать "Конфигурация Ethernet полная",
однако, отметил, что в РЭ ещё не описана ни одна вкладка, добавляемая в конфигурации "полная", а это дополнительно 11 новых вкладок по сравнению с конфигом "краткая" и САН сомневается, надо ли описывать в РЭ все 22 вкладки вместо имеющихся 11.
Если надо, то где найти описание про остальные 10 вкладок конфига "полная",
а если не надо, то зачем тогда описывать "Pause" - одну из 11 дополнительных вкладок?

  • "RX" - из порта принят кадр Pause, передача в порт приостановлена;
  • "TX" - в порт передаются кадры Pause для приостановки передачи удаленной стороной;
  • "RX/TX" - из порта принят кадр Pause, передача в порт приостановлена, одновременно в порт передаются кадры Pause для приостановки передачи удаленной стороной;
  • пусто - кадры Pause не принимаются из порта и не передаются в порт, передача данных возможна в обоих направлениях.

Первые три состояния отображаются на красном фоне.

Надо добавить описание этой функции в руководство.

На это САН не дал однозначного и решительного ответа "быть или не быть"
вкладке "Pause" в РЭ, если быть, то это будет первый подобный прецедент в РЭ.

Кстати, в "Конфигурация Ethernet полная" появляется дополнительная кнопка
"Analyzer Configuration" по которой открывается новое окно
"Analyzer ports Configuration", которое тоже никогда не было описано в РЭ
и даже слова "Analyzer" в РЭ нет и не было. Это тогда тоже надо описывать?

in reply to:  description ; comment:9 by Vladimir, 2 years ago

Replying to alx:

Начиная с sw:r1599 в веб-интерфейсе блока MC04-DSL-3U в таблице "Порты" полной конфигурации ethernet добавлена колонка "Pause", отображающая состояние приема/передачи кадров Pause.

На будущее: если тикет предназначен мне, то указывай поточнее где и как найти нужное место,
а ещё лучше добавить и полное описание, например, в Вики.
В данном случае я не вспомнил, что для доступа к указанной вкладке и указанной колонке надо сначала зайти на вкладку "Разное", там выбрать "полное" и снова открыть вкладку Ethernet -
это мне уже подсказал САН.

in reply to:  8 ; comment:10 by alx, 2 years ago

Replying to Vladimir:

САН сомневается, надо ли описывать в РЭ все 22 вкладки вместо имеющихся 11.

Если интересно мое мнение (раз уж я создатель данного тикета), то оно состоит в том, что все, что есть в веб-интерфейсе, должно быть описано в документации. Логика в данном случае проста: если что-то не будет описано в документации, то пользователь не сможет этим пользоваться (так как не будет знать как).

Как я уже написал в предыдущем комментарии, мы (разработчики блока 3U) не принимали решения, что полный вариант интерфейса не надо описывать вообще никогда, мы просто договорились, что описание функций, которые доступны только в нем (в виду не очень частого использования), отложим в "долгий ящик" на неопределенное "потом", так как есть много других более приоритетных задач по РЭ (например исправление имеющихся в нем ошибок). Вот так лично я помню наше решение по данному вопросу. Если ты считаешь, что уже пришла пора описать и полный вариант интерфейса тоже, то я это только приветствую.

Если надо, то где найти описание про остальные 10 вкладок конфига "полная",

Спросить у разработчика, то есть у меня. Неожиданный ответ, правда? :)

Надо добавить описание этой функции в руководство.

На это САН не дал однозначного и решительного ответа "быть или не быть"

Насколько я вижу, san этот тикет видел (и даже делал несколько технических правок), однако не закрыл его. Следовательно, он, как минимум, не возражает против сделанного мной (по ошибке) предложения. Если считаешь, что пришло время начать описывать полный вариант настроек ethernet, переоткрой этот тикет.

Кстати, в "Конфигурация Ethernet полная" появляется дополнительная кнопка
"Analyzer Configuration"

Эта "новая кнопка" появилась приблизительно 10 лет назад. :)

по которой открывается новое окно
"Analyzer ports Configuration", которое тоже никогда не было описано в РЭ
и даже слова "Analyzer" в РЭ нет и не было. Это тогда тоже надо описывать?

Как я уже написал выше, все, что есть в веб-интерфейсе, должно быть описано в документации, иначе пользователь не сможет этим пользоваться (так как не будет знать как).

Last edited 2 years ago by alx (previous) (diff)

in reply to:  9 ; comment:11 by alx, 2 years ago

Replying to Vladimir:

На будущее: если тикет предназначен мне, то указывай поточнее где и как найти нужное место,

На настоящее: я так и делаю. Например в описании этого тикета сказано: "в веб-интерфейсе блока MC04-DSL-3U в таблице "Порты" полной конфигурации ethernet".

comment:12 by san, 2 years ago

Я не возражаю против описания полных настроек Eth и в принципе согласен с Алексеем.
Но на мой взгляд в РЭ пока хватает намного более значимых пробелов, чем описание этих действительно редко используемых настроек. Когда-то давно мы их "спрятали" и время открывания долгого ящика пока не пришло, на мой взгляд.

in reply to:  11 ; comment:13 by Vladimir, 2 years ago

Replying to alx:

Replying to Vladimir:

На будущее: если тикет предназначен мне, то указывай поточнее где и как найти нужное место,

На настоящее: я так и делаю. Например в описании этого тикета сказано: "в веб-интерфейсе блока MC04-DSL-3U в таблице "Порты" полной конфигурации ethernet".

Но я же пока "незнайка" в этом вопросе, поэтому долго искал, нашёл таблицу Порты, искал там "Pause", не нашёл, проделал кучу лишних телодвижений, не нашёл и пошёл пешком к САН, отвлёк его от работы, чтобы войсом спросить - где же нужная "Pause" находится и как, через что туда попасть и только от него узнал, что надо проделать ещё кучку движений (см. комм-9).
Это у тебя всё быстро на автопилоте получается (пальцы сами набирают то, что надо ;-) ),
а мне надо долго искать :-)

in reply to:  10 ; comment:14 by Vladimir, 2 years ago

Replying to alx:

Replying to Vladimir:

САН сомневается, надо ли описывать в РЭ все 22 вкладки вместо имеющихся 11.

Если интересно мое мнение, то оно состоит в том, что все, что есть в веб-интерфейсе, должно быть описано в документации. Логика в данном случае проста: если что-то не будет описано в документации, то пользователь не сможет этим пользоваться (так как не будет знать как).

И это правильно!

...Если ты считаешь, что уже пришла пора описать и полный вариант интерфейса тоже, то я это только приветствую.


Я подумал, что полный интерфейс надо напечатать в отдельном Приложении,
а в тексте дать ссылку.

Если надо, то где найти описание про остальные 10 вкладок конфига "полная",

Спросить у разработчика, то есть у меня. Неожиданный ответ, правда? :)

Лучше бы разработчик выпустил тикет со ссылками на описание дополнительных вкладок
(чтобы не забыть про то, что надо бы дать описание)

Насколько я вижу, san этот тикет видел (и даже делал несколько технических правок), однако не закрыл его. Следовательно, он, как минимум, не возражает против сделанного мной (по ошибке) предложения. Если считаешь, что пришло время начать описывать полный вариант настроек ethernet, переоткрой этот тикет.

Я ещё не научился переоткрывать тикеты, а у тебя это ловко получается -
вот и переоткрыл бы на долгую и добрую память :-) (без этого я забуду)

Когда я закончу оставшиеся 88 тикетов, то возьмусь и за это
(если будут ссылки на подробные Вики-статьи про это ;-) ).

Кстати, в "Конфигурация Ethernet полная" появляется дополнительная кнопка
"Analyzer Configuration"

Эта "новая кнопка" появилась приблизительно 10 лет назад. :)

Для меня - первый раз за все 73 года жизни :-)

по которой открывается новое окно
"Analyzer ports Configuration", которое тоже никогда не было описано в РЭ
и даже слова "Analyzer" в РЭ нет и не было. Это тогда тоже надо описывать?

Как я уже написал выше, все, что есть в веб-интерфейсе, должно быть описано в документации, иначе пользователь не сможет этим пользоваться (так как не будет знать как).

Оформил бы ты на память тикет и про это с минимальным приоритетом!

in reply to:  13 ; comment:15 by alx, 2 years ago

Replying to Vladimir:

Но я же пока "незнайка" в этом вопросе, поэтому долго искал, нашёл таблицу Порты, искал там "Pause", не нашёл, проделал кучу лишних телодвижений, не нашёл и пошёл пешком к САН, отвлёк его от работы, чтобы войсом спросить - где же нужная "Pause" находится и как, через что туда попасть и только от него узнал, что надо проделать ещё кучку движений (см. комм-9).

Разве тебе пришлось делать все описанное выше из-за того, что я не указал, где находится колонка "Pause"? В comment:8 ты сам написал почему:

упустил из вида слово "в таблице "Порты" полной конфигурации ethernet".

Потому что ты упустил то, что я написал, а не потому, что я не написал... Я, конечно, сожалею, что тебе пришлось проделать путь до san и обратно, но свою вину вижу лишь в том, что по ошибке этот тикет создал. Еще раз прошу за это прощения.

in reply to:  14 ; comment:16 by alx, 2 years ago

Resolution: invalid
Status: closedreopened

Replying to Vladimir:

Я подумал, что полный интерфейс надо напечатать в отдельном Приложении,
а в тексте дать ссылку.

Лично я смысла в таком отделении не вижу, но разработчик - ты, тебе и решать.

Лучше бы разработчик выпустил тикет со ссылками на описание дополнительных вкладок
(чтобы не забыть про то, что надо бы дать описание)

Хорошо, выпущу по мере возможности. Но тогда проще прямо в тикетах и писать - зачем плодить лишние сущности и лишние ссылки?

Я ещё не научился переоткрывать тикеты,

Это совсем не сложно: в разделе "Изменить карточку" в панели "действия" ставишь радиобатон на пункт "reopen".

а у тебя это ловко получается - вот и переоткрыл бы на долгую и добрую память :-) (без этого я забуду)

По твоей просьбе переоткрыл тикет.

Кстати, в "Конфигурация Ethernet полная" появляется дополнительная кнопка
"Analyzer Configuration"

Эта "новая кнопка" появилась приблизительно 10 лет назад. :)

Для меня - первый раз за все 73 года жизни :-)

Вот я и говорю, что для тебя вообще все, что разработано в АДС - это "недавно".

Оформил бы ты на память тикет

Как я уже пообещал, буду писать тикеты по мере возможности (свободного времени).

и про это с минимальным приоритетом!

Владелец тикетов - ты, вот ты и распределяй задачи по приоритетам, как считаешь нужным и правильным.

Last edited 2 years ago by alx (previous) (diff)

comment:17 by san, 2 years ago

Description: modified (diff)
Priority: majortrivial

Создал wiki/Ethernet для описания полной конфигурации Ethernet, добавил туда описание колонки Pause, предлагаю по возможности добавлять на эту страничку описание настроек полной конфигурации ethernet.

по ошибке этот тикет создал

Расширю тему тикета до предложения описать настройки полной конфигурации ethernet.

comment:18 by san, 2 years ago

Summary: Добавить в РЭ ethernet->Порты-> "Pause"Добавить в РЭ описание полной конфигурации Ethernet

in reply to:  17 ; comment:19 by alx, 2 years ago

Replying to san:

Создал wiki/Ethernet для описания полной конфигурации Ethernet, добавил туда описание колонки Pause, предлагаю по возможности добавлять на эту страничку описание настроек полной конфигурации ethernet.

Не понимаю, в чем смысл иметь дубликат того, что описано в РЭ. Ты сам всегда говорил, что это нерационально - каждый раз, когда что-то изменится в аппаратуре, придется изменять описание сразу в двух местах - в РЭ и в wiki...

comment:20 by san, 2 years ago

иметь дубликат

Если эта информация таки попадёт в РЭ страничку можно будет удалить.
Иногда какие-то кусочки описания появляются сами собой, например когда одному из пользователей объясняешь что-то, или вот ты по ошибке написал кусочек описания. Эти кусочки пока недостаточны для добавления в РЭ, но лучше чем совсем ничего.

in reply to:  20 comment:21 by alx, 2 years ago

Replying to san:

Иногда какие-то кусочки описания появляются сами собой, например когда одному из пользователей объясняешь что-то,

Насколько я могу видеть, за последние 10 лет ни одного кусочка описания полных настроек ethernet "само собой" не появилось. :)

или вот ты по ошибке написал кусочек описания.

Так я же его написал не в wiki, а в тикете, и дальше предлагал делать так же...

in reply to:  15 comment:22 by Vladimir, 2 years ago

Replying to alx:

Replying to Vladimir:

упустил из вида слово "в таблице "Порты" полной конфигурации ethernet".

Потому что ты упустил то, что я написал, а не потому, что я не написал... Я, конечно, сожалею, что тебе пришлось проделать путь до san и обратно, но свою вину вижу лишь в том, что по ошибке этот тикет создал. Еще раз прошу за это прощения.

Вот если бы у тебя было написано, как у САН в ​https://trac.adc-line.ru/sw-01/intertrac/wiki/Ethernet (см.комм-17):
"Для отображения расширенных настроек Ethernet нужно на вкладке "Разное" в настройке "Конфигурация Ethernet" выбрать вариант "полная".", то любой юзер и я нашли бы очень очень быстро нужную вкладку без посторонней помощи :-)

comment:23 by san, 2 years ago

ни одного кусочка описания полных настроек ethernet "само собой" не появилось. :)

По другим вопросам иногда появляется. То что не "готово" войти в РЭ, но представляет интерес для пользователя я иногда добавляю в вики, думаю что это более логичное место поиска информации чем тикет.

in reply to:  16 ; comment:24 by Vladimir, 2 years ago

Replying to alx:

Replying to Vladimir:

Я подумал, что полный интерфейс надо напечатать в отдельном Приложении,
а в тексте дать ссылку.

Лично я смысла в таком отделении не вижу, но разработчик - ты, тебе и решать.

Смысл в том, чтобы не засорять и без того огромный текст РЭ информацией, которой крайне редко пользуются на эксплуатации (это должно бы быть подробное описание 11 новых вкладок).
Но решать по рангу должен бы САН - он чаще общается с юзерами и ему видней.

... проще прямо в тикетах и писать - зачем плодить лишние сущности и лишние ссылки?

В тикетах пишут кратко, тезисно, для РЭ желательно подробнее, а огромные тикеты это не хорошо.

в разделе "Изменить карточку" в панели "действия" ставишь радиобатон на пункт "reopen".

Спасибо.

in reply to:  23 comment:25 by Vladimir, 2 years ago

Replying to san:

ни одного кусочка описания полных настроек ethernet "само собой" не появилось. :)

По другим вопросам иногда появляется. То что не "готово" войти в РЭ, но представляет интерес для пользователя я иногда добавляю в вики, думаю что это более логичное место поиска информации чем тикет.

Тикеты приходят мне на почту и автоматически попадают в папку "TRAC",
причём жирным шрифтом с сортировкой во дате-времени и я их сразу вижу,
а новые Вики я могу пропустить и не увидеть, и не узнать, и не использовать...
Поэтому ссылка в тикете мне удобнее: я сразу из мэйлера могу открыть и тикет и Вики.

in reply to:  24 ; comment:26 by alx, 2 years ago

Replying to Vladimir:

В тикетах пишут кратко, тезисно,

Кто и когда установил такое правило? :) Мне о нем ничего не известно.

in reply to:  26 comment:27 by Vladimir, 2 years ago

Replying to alx:

Replying to Vladimir:

В тикетах пишут кратко, тезисно,

Кто и когда установил такое правило? :) Мне о нем ничего не известно.

Мне так показалось, т.к. тикеты чаще всего относительно короткие,
а реализация в РЭ занимает много страниц, чаще всего взятых из Вики,
т.е. это не правило, а скорее де-факто с редкими исключениями :-)

in reply to:  17 comment:28 by Vladimir, 2 years ago

Replying to san:

Создал wiki/Ethernet для описания полной конфигурации Ethernet, добавил туда описание колонки Pause, предлагаю по возможности добавлять на эту страничку описание настроек полной конфигурации ethernet.
Расширю тему тикета до предложения описать настройки полной конфигурации ethernet.

Эта огромная Вики-статья уже созрела для публикации в РЭ или ждём ещё 5 лет? :-)
Я тут ничего изменить/добавить/убавить не могу...
На данный момент это самый старый тикет, который касается РЭ.

in reply to:  17 comment:29 by Vladimir, 17 months ago

Description: modified (diff)
Resolution: готово
Status: reopenedclosed

Replying to san:
В РЭ-55 от 01.12.2022 добавил ссылку на полную конфигурацию вкладки Ethernet.

Расширю тему тикета до предложения описать настройки полной конфигурации ethernet.

В пункте "6.2.3 Вкладка Ethernet - настройка коммутатора платы SW-01" по предложению САН дополнил текст:
"Рис. 6.8 Вкладка Ethernet отображает состояние портов коммутатора платы SW-01.
Описание вкладки Ethernet приводится в режиме краткая (см. на Рис. 6.9 табличку Конфигурация Ethernet вкладки Разное). Описание вкладки Ethernet в режиме полная
доступно по ссылке: https://trac.adc-line.ru/sw-01/wiki/Ethernet (расширенные настройки)."

comment:30 by alx, 17 months ago

Правильно ли я понял, что вкладка "Ethernet" в режиме "полная" в РЭ-55 описана?

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

in reply to:  30 ; comment:31 by Vladimir, 17 months ago

Replying to alx:

Правильно ли я понял, что вкладка "Ethernet" в режиме "полная" в РЭ-55 описана?

Если считать ссылку описанием, то описана, текст описания в РЭ-55 дословно такой:
" Описание вкладки Ethernet в режиме полная доступно по ссылке:
https://trac.adc-line.ru/sw-01/wiki/Ethernet (расширенные настройки).".

Текст описания по ссылке на Вики огромный и редко кому нужный,
а продвинутые юзеры прочитают по ссылке, поэтому САН предложил в РЭ ограничиться
указанием ссылки на источник полного описания.

in reply to:  31 comment:32 by alx, 17 months ago

Replying to Vladimir:

Правильно ли я понял, что вкладка "Ethernet" в режиме "полная" в РЭ-55 описана?

Если считать ссылку описанием, то описана,

Судя по тому, что тикет закрыт с резолюцией "готово", ты считаешь ссылку описанием.
Спасибо за уточнение.

in reply to:  31 ; comment:33 by alx, 17 months ago

Replying to Vladimir:

продвинутые юзеры прочитают по ссылке,

Жаль, что ты раньше об этом не догадался. Столько описаний из разных веб-страниц уже скопировано в РЭ, в то время как можно было просто дать ссылки... :)

поэтому САН предложил в РЭ ограничиться указанием ссылки на источник полного описания.

Вообще-то san предлагал не это. В comment:20 он писал: "Если эта информация таки попадёт в РЭ страничку можно будет удалить". То есть san предполагал, что в РЭ будет дана не ссылка на страничку, а собственно информация со странички...

in reply to:  33 comment:34 by Vladimir, 17 months ago

Replying to alx:

Replying to Vladimir:

продвинутые юзеры прочитают по ссылке,

Жаль, что ты раньше об этом не догадался. Столько описаний из разных веб-страниц уже скопировано в РЭ, в то время как можно было просто дать ссылки... :)

Я только условно Автор, а скорее - исполнитель-редактор:
что надо, и чего не надо, и как надо - решают Авторы харда и софта,
это должны делать Знатоки, а не исполнители, которые печатают то,
что считают нужным Знатоки, среди которых, в частности, ты и САН :-)

поэтому САН предложил в РЭ ограничиться указанием ссылки на источник полного описания.

Вообще-то san предлагал не это. В comment:20 он писал: "Если эта информация таки попадёт в РЭ страничку можно будет удалить". То есть san предполагал, что в РЭ будет дана не ссылка на страничку, а собственно информация со странички...

Это он предлагал "до, раньше того, как", а сегодня, в данном случае в связи с редко используемым юзерами полными настройками и огромным текстом, САН устно предложил мне ограничиться ссылкой на Вики,
что я и сделал, а если САН скажет, что текст из Вики надо обязательно вставить в РЭ, то я вставлю,
даже если считаю, что это не надо! :-)

comment:35 by san, 17 months ago

Если эта информация таки попадёт в РЭ страничку можно будет удалит

Пользуясь случаем, замечу что насчёт удаления я давно передумал) Видимо раньше я был более оптимистично настроен по поводу актуальности и корректности РЭ :-D
Я думаю, что дублированная информации в вики никому не помешает, а часто она даже более надёжна и информативна чем РЭ, поэтому пусть вики живёт своей жизнью а РЭ своей.

Я предложил добавить в РЭ пока ссылку, т.к. я не готов сейчас изучить весь объём материала и оценить что нужно добавить в РЭ и куда, а чего не хватает и что об этом сказать пользователю.
Бездумно вставлять весь кусок текста куда-попало я не хочу, ссылка лучше чем ничего.
Если Vladimir готов осмысленно перенести эту информацию в РЭ, то я не возражаю.

редко используемым юзерами полными настройками

Возможно они редко используемые как раз потому что у пользователя нет информации как ими пользоваться.

in reply to:  35 ; comment:36 by alx, 17 months ago

Replying to san:

Я предложил добавить в РЭ пока ссылку,

Уточни, пожалуйста, слово "пока". Судя по тому, что тикет закрыт с резолюцией "готово", Vladimir понял твое устное предложение добавить ссылку как окончательное решение. Если так, то с этого момента wiki-статья становится частью РЭ, и забота о ее редактировании переходит к Vladimir...

comment:37 by san, 17 months ago

Resolution: готово
Status: closedreopened

Во имя спасения Vladimir от тяжкого бремени редактирования вики-статьи и с надеждой когда-нибудь увидеть в РЭ информацию о работе коммутатора в SW-01 переоткрою тикет :)

in reply to:  36 ; comment:38 by Vladimir, 17 months ago

Replying to alx:

Replying to san:

Я предложил добавить в РЭ пока ссылку,

Vladimir понял твое устное предложение добавить ссылку как окончательное решение. Если так, то с этого момента wiki-статья становится частью РЭ, и забота о ее редактировании переходит к Vladimir...

В РЭ-42 уже есть 8 ссылок, начинающихся с "https://" и 8 ссылок "http://" -
тогда я ДОЛЖЕН и ОБЯЗАН редактировать тексты всех этих 16 ссылок? :-), даже в такой длинной:
"(https://trac.adc-line.ru/sw-01/raw-attachment/wiki/ZabbixAgent/zbx_template_mc04-dsl-3u-agent.zip)"?
Ты считаешь меня Богом? :-)))

in reply to:  38 ; comment:39 by alx, 17 months ago

Replying to Vladimir:

В РЭ-42 уже есть 8 ссылок, начинающихся с "https://" и 8 ссылок "http://" -
тогда я ДОЛЖЕН и ОБЯЗАН редактировать тексты всех этих 16 ссылок?

Документы по этим 16 ссылкам описывают эксплуатацию аппаратуры MC04-DSL-3U?

Ты считаешь меня Богом? :-)))

Нет.

in reply to:  39 ; comment:40 by Vladimir, 17 months ago

Replying to alx:

Replying to Vladimir:

В РЭ-42 уже есть 8 ссылок, начинающихся с "https://" и 8 ссылок "http://" -
тогда я ДОЛЖЕН и ОБЯЗАН редактировать тексты всех этих 16 ссылок?

Документы по этим 16 ссылкам описывают эксплуатацию аппаратуры MC04-DSL-3U?

Можно, наверное, обойтись и без них, но для общего и более глубокого понимания
возможностей настройки конфигурации ethernet
наиболее подготовленные юзеры смогут получить более полную информацию,
однако, до сих пор уже более 10 лет нашу ЦСП эксплуатируют
и без описания в РЭ, и без ссылки на полную конфигурацию Ethernet :-)

Ты считаешь меня Богом? :-)))

Нет.

Тогда я не смогу редактировать информацию во всех ссылках на статьи наших и чужих
Разработчиков харда и софта, и вряд ли кто сможет (кроме тебя :-) ).

in reply to:  40 ; comment:41 by alx, 17 months ago

Replying to Vladimir:

Документы по этим 16 ссылкам описывают эксплуатацию аппаратуры MC04-DSL-3U?

Можно, наверное, обойтись и без них, но для общего и более глубокого понимания
возможностей настройки конфигурации ethernet
наиболее подготовленные юзеры смогут получить более полную информацию,
однако, до сих пор уже более 10 лет нашу ЦСП эксплуатируют
и без описания в РЭ, и без ссылки на полную конфигурацию Ethernet :-)

Если это был ответ на мой вопрос, то я его не понял. Это значит "Да, все 16 документов по этим ссылкам описывают эксплуатацию MC04-DSL-3U (и этой информации нет в тексте РЭ)? Или это значит "Нет, не все и не описывают"?

in reply to:  41 ; comment:42 by Vladimir, 17 months ago

Replying to alx:

Replying to Vladimir:

Документы по этим 16 ссылкам описывают эксплуатацию аппаратуры MC04-DSL-3U?

Можно, наверное, обойтись и без них, но для общего и более глубокого понимания
возможностей настройки конфигурации ethernet
наиболее подготовленные юзеры смогут получить более полную информацию,
однако, до сих пор уже более 10 лет нашу ЦСП эксплуатируют
и без описания в РЭ, и без ссылки на полную конфигурацию Ethernet :-)

Если это был ответ на мой вопрос, то я его не понял. Это значит "Да, все 16 документов по этим ссылкам описывают эксплуатацию MC04-DSL-3U (и этой информации нет в тексте РЭ)? Или это значит "Нет, не все и не описывают"?

Это дополнительная, но необязательная для эксплуатации часть описания:
её отсутствие позволяет успешно эксплуатировать ЦСП уже более 10 лет.
Но при любом раскладе никто не сможет полноценно редактировать эту информацию, кроме её истинных Авторов.
По любым проблемам и вопросам юзеры могут обращаться в нашу техподдержку.
Ссылки нужны часто нам самим, чтобы не искать их в случае необходимости :-)
Например:
"Также можно воспользоваться готовыми шаблонами (https://trac.adc-line.ru/sw-01/raw-attachment/wiki/ZabbixAgent/zbx_template_mc04-dsl-3u-agent.zip)."
а можно и не воспользоваться :-) Т.е. это дополнительная возможность...

in reply to:  42 comment:43 by alx, 17 months ago

Replying to Vladimir:

Если это был ответ на мой вопрос, то я его не понял.

Это дополнительная, но необязательная для эксплуатации часть описания

Я понял твой ответ как "Нет". В таком случае (отвечая на твой исходный вопрос), нет, ты не обязан редактировать тексты по всем этим 16 ссылкам, так как они не являются частями РЭ.

comment:44 by san, 15 months ago

milestone: 2 очередь

Milestone deleted

in reply to:  16 ; comment:45 by Vladimir, 11 months ago

Resolution: готово
Status: reopenedclosed

Replying to alx:

Replying to Vladimir:

Я подумал, что полный интерфейс надо напечатать в отдельном Приложении,
а в тексте дать ссылку.


По твоей просьбе переоткрыл тикет.

Владелец тикетов - ты, вот ты и распределяй задачи по приоритетам, как считаешь нужным и правильным.

САН сказал, что для РЭ достаточно разместить только ссылку
" ​wiki/Ethernet для описания полной конфигурации Ethernet",
и при этом он не считает меня автором текста по этой ссылке,
и не считает, что если я размещаю ссылку, то я же и должен редактировать текст по этой ссылке.
(текст по этой ссылке займёт дополнительно порядка 40 страниц в РЭ).

В связи с этим САН и теперь я считаем, что этот тикет выполнен путём размещения в РЭ
ссылки на текст с подробным описанием полной конфигурации Ethernet.

В РЭ-56 этот тикет уже был реализован.

Last edited 11 months ago by Vladimir (previous) (diff)

in reply to:  45 ; comment:46 by alx, 11 months ago

Replying to Vladimir:

В связи с этим САН и теперь я считаем, что этот тикет выполнен путём размещения в РЭ
ссылки на текст с подробным описанием полной конфигурации Ethernet.

Супер!!! :) Я предлагаю быть последовательным и все остальные описания функций, которые есть в интернете, тоже заменить ссылками.

in reply to:  46 ; comment:47 by Vladimir, 11 months ago

Replying to alx:

Replying to Vladimir:

В связи с этим САН и теперь я считаем, что этот тикет выполнен путём размещения в РЭ
ссылки на текст с подробным описанием полной конфигурации Ethernet.

Супер!!! :) Я предлагаю быть последовательным и все остальные описания функций, которые есть в интернете, тоже заменить ссылками.

Всё хорошо только в меру: копировать в РЭ из каждой ссылки до 40 и более страниц - это тоже абсурд :-)
(особенно, если эти десятки страниц требуются только нескольким человекам 1-2 раза в жизни).
В РЭ-56 уже есть 9 ссылок, начинающихся с "​https://" и 8 ссылок "​http://"
Если в каждой ссылке будет, например, 30 страниц, то в сумме получится +510 страниц - больше, чем в РЭ-56!
Хорошо ли иметь РЭ порядка 1000 страниц из которых юзеру потребуется не более 400 ?

in reply to:  47 ; comment:48 by alx, 11 months ago

Replying to Vladimir:

Хорошо ли иметь РЭ порядка 1000 страниц из которых юзеру потребуется не более 400 ?

Это не хорошо и не плохо - это нормально, так как мы не можем знать заранее, какие именно 400 из этих 1000 страниц потребуются пользователю. Если бы мы знали заранее, что какие-то функции аппаратуры никогда никому не будут нужны - зачем бы мы тогда их вообще делали? :) Сделали - потому что считали, что кому-то когда-то эта функция может потребоваться. А раз она может потребоваться - значит в РЭ должно быть описано, как ей пользоваться. По-моему так. Если пользователю потребуется даже не 400, а одна страница, которая как раз попадет в число тех 600, которых в РЭ нет - вот это будет плохо, так как пользователь не сможет воспользоваться нужной ему функцией аппаратуры.

comment:49 by san, 11 months ago

В связи с этим САН и теперь я считаем, что этот тикет выполнен путём размещения в РЭ

Уточню что в устном разговоре речь шла о закрытии тикета с резолюцией "не будем делать" а не "готово".

in reply to:  49 comment:50 by Vladimir, 11 months ago

Replying to san:

В связи с этим САН и теперь я считаем, что этот тикет выполнен путём размещения в РЭ

Уточню что в устном разговоре речь шла о закрытии тикета с резолюцией "не будем делать" а не "готово".

Согласен, но это не играет роли, т.к. результат одинаковый: клозед (closed) :-)

in reply to:  48 comment:51 by Vladimir, 11 months ago

Replying to alx:

Replying to Vladimir:

Хорошо ли иметь РЭ порядка 1000 страниц из которых юзеру потребуется не более 400 ?

Это не хорошо и не плохо - это нормально, так как мы не можем знать заранее, какие именно 400 из этих 1000 страниц потребуются пользователю. Если бы мы знали заранее, что какие-то функции аппаратуры никогда никому не будут нужны - зачем бы мы тогда их вообще делали? :) Сделали - потому что считали, что кому-то когда-то эта функция может потребоваться. А раз она может потребоваться - значит в РЭ должно быть описано, как ей пользоваться. По-моему так. Если пользователю потребуется даже не 400, а одна страница, которая как раз попадет в число тех 600, которых в РЭ нет - вот это будет плохо, так как пользователь не сможет воспользоваться нужной ему функцией аппаратуры.

Тот, кому потребуется "описание полной конфигурации Ethernet" с вероятностью 100% имеет доступ к интернету
и он в одно касание увидит требуемую ему информацию по указанной в РЭ ссылке.
Однако, можно предположить, что эта потребность будет у одного из тысяч юзеров нашей ЦСП 1 раз в несколько лет - так зачем же для этого редчайшего случая засорять РЭ десятками страниц легко доступного в сети текста? :-)
Эта ссылка появилась в РЭ только в январе этого года - а до этого 11 лет все юзеры успешно эксплуатировали нашу ЦСП 11 лет!

comment:52 by alx, 11 months ago

Я думаю, что все участники обсуждения обменялись своими мнениями.

Так как РЭ MC04-DSL-3U теперь официально и окончательно ссылается на sw:wiki:Ethernet как на описание части функционала аппаратуры, эта статья, таким образом, становится частью РЭ. И, следовательно, забота о ее редактировании теперь лежит на Vladimir. Был рад помочь в улучшении РЭ.

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

comment:53 by san, 11 months ago

Так как РЭ MC04-DSL-3U теперь официально ссылается на ​sw:wiki:Ethernet как на описание части функционала аппаратуры, эта статья, таким образом, становится частью РЭ.

Хм. Странная логика.
А когда В.А. сослался на описание Zabbix в РЭ, он стал автором описания Zabbix?

Я воспринимаю эту ссылку, как ссылку на дополнительную информацию, которая может заинтересовать пользователя. а не как часть РЭ.

in reply to:  53 ; comment:54 by alx, 11 months ago

Replying to san:

Хм. Странная логика.
А когда В.А. сослался на описание Zabbix в РЭ, он стал автором описания Zabbix?

Странный вопрос... Нет, не стал, конечно, ведь он, насколько мне известно, этого описания не писал.

Я воспринимаю эту ссылку, как ссылку на дополнительную информацию, которая может заинтересовать пользователя. а не как часть РЭ.

Хм... Я понял написанное в comment:45 так, что принято окончательное решение о том, что ссылка на wiki-статью будет вместо описания в собственно РЭ, а не дополнительно к нему. То есть что кроме этой wiki-статьи, на которую размещена ссылка, эксплуатация аппаратуры (в части описанного в статье) нигде больше не описана. И если так, то по-моему это ни разу не дополнительная информация, а основная и единственная - без этой статьи пользователь ниоткуда больше не сможет узнать как, например, в веб-интерфейсе блока MC04-DSL-3U настроить планировщик очередей...

Или я понял неправильно? Vladimir, уточни, пожалуйста, правильно ли я тебя понял.

in reply to:  54 ; comment:55 by Vladimir, 11 months ago

Replying to alx:

Replying to san:

Я воспринимаю эту ссылку, как ссылку на дополнительную информацию, которая может заинтересовать пользователя. а не как часть РЭ.

Хм... Я понял написанное в comment:45 так, что принято окончательное решение о том, что ссылка на wiki-статью будет вместо описания в собственно РЭ, а не дополнительно к нему. ....- без этой статьи пользователь ниоткуда больше не сможет узнать как, например, в веб-интерфейсе блока MC04-DSL-3U настроить планировщик очередей...

Запросто сможет в 1 клик по нашей ссылке! Или позвонит в нашу техподдержку!

Или я понял неправильно? Vladimir, уточни, пожалуйста, правильно ли я тебя понял.

Обсуждение уже перешло на уровень Истинных Знатоков и Разработчиков Харда и Софта: Алекса и САН.
Моё мнение: эта ссылка факультативная, информация опциональная для наиболее любознательных
и опытных юзеров-программистов, поэтому добавлять в РЭ +40 страниц по этой ссылке и ещё десятки страниц по подобным ссылкам нет смысла, к тому же АДС гарантирует техническую поддержку по своим изделиям.
Ну, или уж должен быть отдельный Документ АДС для юзеров-программистов, сисопов, сисадминов и т.п. -
вот там можно и разместить все тексты по всем ссылкам - но надо ли это, если всю требуемую информацию можно получить в 1 клик на наши ссылки?

comment:56 by san, 11 months ago

Я таки всё равно не понимаю логику передачи ответственности за статью.

Есть некая функция в аппаратуре, которая не нужна 90+% пользователей и которая описана отдельно от РЭ. Можно считать это не документируемой (официально) возможностью. Но если пользователь захочет попробовать на свой страх и риск, то мы ему даём ссылку на описание этой функции, не связанную с РЭ.

in reply to:  52 ; comment:57 by Vladimir, 11 months ago

Replying to alx:

Я думаю, что все участники обсуждения обменялись своими мнениями.

Так как РЭ MC04-DSL-3U теперь официально и окончательно ссылается на sw:wiki:Ethernet как на описание части функционала аппаратуры, эта статья, таким образом, становится частью РЭ. И, следовательно, забота о ее редактировании теперь лежит на Vladimir. Был рад помочь в улучшении РЭ.

А может ли не Автор этой статьи редактировать её?
А если может, то как защитить статью от изменения, если не автор может напечатать там ложь? :-)

in reply to:  55 ; comment:58 by alx, 11 months ago

Replying to Vladimir:

без этой статьи пользователь ниоткуда больше не сможет узнать как, например, в веб-интерфейсе блока MC04-DSL-3U настроить планировщик очередей...

Запросто сможет в 1 клик по нашей ссылке!

Читай, пожалуйста, внимательнее то, что я пишу (и тем более что ты сам же цитируешь)! У меня написано: "без этой статьи". Элементарная логика подсказывает, что если этой статьи нет, то при клике ссылки на несуществующую статью пользователь получит сообщение об ошибке (404 страница не найдена).

Или позвонит в нашу техподдержку!

По такой логике РЭ вообще не нужно. Зачем мы тогда вообще здесь тратим наше время? Закрывай все тикеты с резолюцией "Не будем делать", и давай займемся чем-нибудь более полезным, чем РЭ...

Или я понял неправильно? Vladimir, уточни, пожалуйста, правильно ли я тебя понял.

Обсуждение уже перешло на уровень Истинных Знатоков и Разработчиков Харда и Софта: Алекса и САН.
Моё мнение: эта ссылка факультативная, информация опциональная для наиболее любознательных
и опытных юзеров-программистов, поэтому добавлять в РЭ +40 страниц по этой ссылке и ещё десятки страниц по подобным ссылкам нет смысла, к тому же АДС гарантирует техническую поддержку по своим изделиям.
Ну, или уж должен быть отдельный Документ АДС для юзеров-программистов, сисопов, сисадминов и т.п. -
вот там можно и разместить все тексты по всем ссылкам - но надо ли это, если всю требуемую информацию можно получить в 1 клик на наши ссылки?

Большое спасибо за такой подробный и развернутый ответ на мой вопрос, но, к сожалению, я не уверен, что после прочтения всего этого я правильно его понял. :) Иногда большой объем текста не способствует пониманию... :) Уточни, пожалуйста, еще раз, на этот раз только либо "да, ты понял правильно", либо "нет, ты понял неправильно". Заранее благодарю.

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

in reply to:  56 ; comment:59 by alx, 11 months ago

Replying to san:

Я таки всё равно не понимаю логику передачи ответственности за статью.

Логика следующая. Есть руководство по эксплуатации, за которое отвечает Vladimir. И есть статья, которую может править кто угодно (из сотрудников АДС). Теперь Vladimir принимает решение не переписывать содержание этой статьи в РЭ (как он делал, например, в случае с описанием канального окончания DS платы VE-01), а предлагает пользователям аппаратуры идти и читать сам оригинал статьи в интернете. Таким образом, текст этой статьи становится частью руководства по эксплуатации (оно теперь состоит из двух частей - документа PDF и документа HTML). Логично? По-моему да. Получается, что теперь ни я, ни кто-либо еще кроме Vladimir не имеет полномочий вносить изменения в эту статью, так как это было бы вмешательством в его (Vladimir'а) работу. Ровно так же, как было бы неправильным "через голову" Vladimir'а изменять что-то в том документе PDF, который опубликован на сайте. По-моему так.

Это как если бы ты или Vladimir исправил бы что-то в лежащей в архиве разработанной мной PCB платы SW-01 - как думаешь, это было бы правильно? По-моему нет. Если кто-то считает, что в SW-01 надо внести какие-то изменения, пусть предлагает сделать это мне как разработчику платы. Я рассмотрю предложение и либо внесу эти изменения, либо нет. Ну или начальник может назначить другого разработчика вместо меня, и тогда уже он будет вносить изменения в плату, а я не буду...

Надеюсь, что теперь я понятно объяснил логику.

Есть некая функция в аппаратуре, которая не нужна 90+% пользователей и которая описана отдельно от РЭ. Можно считать это не документируемой (официально) возможностью.

Можно. Но я считаю это неправильным. Я считаю, что все функции аппаратуры должны быть описаны в эксплуатационной документации независимо от процента пользователей, которым она будет нужна. Недокументированных функций быть не должно. Если функция есть - мы должны ее описать, чтобы дать пользователю возможность этой функцией пользоваться. А воспользуется он этой предоставленной нами возможностью или нет - это решать ему, а не нам.

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

in reply to:  57 ; comment:60 by alx, 11 months ago

Replying to Vladimir:

А может ли не Автор этой статьи редактировать её?

Да. Редактирование статей wiki разрешено всем сотрудникам АДС (остальным запрещено). Да и вообще сама технология wiki (не конкретно в trac, а вообще) была задумана для коллективного творчества и авторства - чтобы любой мог вносить правки в любую статью. Смотри, например, как работает Wikipedia...

А если может, то как защитить статью от изменения, если не автор может напечатать там ложь? :-)

Прямо сейчас такой возможности нет (права можно назначать только для всех статей проекта сразу, не дифференцировано). Но вроде бы существует какой-то плагин, который позволяет устанавливать права доступа отдельным статьям индивидуально. Я деталями не интересовался в виду отсутствия такой необходимости. Постараюсь попозже найти и посмотреть...

in reply to:  60 comment:61 by alx, 11 months ago

Replying to alx:

Прямо сейчас такой возможности нет (права можно назначать только для всех статей проекта сразу, не дифференцировано).

Оказалось, что в новой версии trac (на которую мы сравнительно недавно перешли) плагин, позволяющий избирательно устанавливать права на любые ресурсы уже есть, и ничего дополнительно не требуется, его надо только включить. Благодаря этому я только что его включил и настроил права соответствующим образом. Так что не волнуйся, теперь изменить, удалить или переименовать sw:wiki:Ethernet никто кроме тебя не может.

in reply to:  58 ; comment:62 by Vladimir, 10 months ago

Replying to alx:

Replying to Vladimir:

без этой статьи пользователь ниоткуда больше не сможет узнать как, например, в веб-интерфейсе блока MC04-DSL-3U настроить планировщик очередей...

Запросто сможет в 1 клик по нашей ссылке!

У меня написано: "без этой статьи". Элементарная логика подсказывает, что если этой статьи нет, то при клике ссылки на несуществующую статью пользователь получит сообщение об ошибке (404 страница не найдена).

А ты опять не догадался, что "по нашей ссылке" конечно же имелась ввиду ссылка в нашем РЭ,
например, в РЭ-56 на стр.174:
"Описание вкладки Ethernet в режиме полная доступно по ссылке: https://trac.adc-line.ru/sw-01/wiki/Ethernet (расширенные настройки)." - эта ссылка открывается без ошибок в одно касание.

Или я понял неправильно? Vladimir, уточни, пожалуйста, правильно ли я тебя понял.

Обсуждение уже перешло на уровень Истинных Знатоков и Разработчиков Харда и Софта: Алекса и САН.
Моё мнение: эта ссылка факультативная, информация опциональная для наиболее любознательных
и опытных юзеров-программистов, поэтому добавлять в РЭ +40 страниц по этой ссылке и ещё десятки страниц по подобным ссылкам нет смысла, к тому же АДС гарантирует техническую поддержку по своим изделиям.
Ну, или уж должен быть отдельный Документ АДС для юзеров-программистов, сисопов, сисадминов и т.п. -
вот там можно и разместить все тексты по всем ссылкам - но надо ли это, если всю требуемую информацию можно получить в 1 клик на наши ссылки?

Большое спасибо за такой подробный и развернутый ответ на мой вопрос, но, к сожалению, я не уверен, что после прочтения всего этого я правильно его понял. :) Иногда большой объем текста не способствует пониманию... :) Уточни, пожалуйста, еще раз, на этот раз только либо "да, ты понял правильно", либо "нет, ты понял неправильно". Заранее благодарю.

"да, ты понял правильно" - "ссылка на wiki-статью будет вместо описания в собственно РЭ".
При любом решении будет ссылка, только в одном случает на статью с Трак,
а в другом случае ссылка на очередное Приложение из 40 страниц в конце текста РЭ.
Любой юзер в обеих случаях прочитает одно и то же буква в букву - зачем тогда добавлять в РЭ 40 страниц,
которые потребуются, возможно одному из тысячи юзеров и, возможно, 1 раз в жизни?
Обрати внимание, что твой вопрос был в твоём ответе на Коммент 53 от САН:
"Я воспринимаю эту ссылку, как ссылку на дополнительную информацию, которая может заинтересовать пользователя,
а не как часть РЭ
" - как он скажет, так я и сделаю:
скопировать 40 страниц текста по ссылке и добавить в РЭ не трудно, и не долго :-)

Last edited 10 months ago by Vladimir (previous) (diff)

in reply to:  62 ; comment:63 by alx, 10 months ago

Replying to Vladimir:

А ты опять не догадался, что "по нашей ссылке" конечно же имелась ввиду ссылка в нашем РЭ,

Я догадался, что речь шла о ссылке в нашем РЭ.

"да, ты понял правильно"

Отлично!

in reply to:  63 ; comment:64 by Vladimir, 10 months ago

Replying to alx:

Replying to Vladimir:

А ты опять не догадался, что "по нашей ссылке" конечно же имелась ввиду ссылка в нашем РЭ,

Я догадался, что речь шла о ссылке в нашем РЭ.

"да, ты понял правильно"

Тогда почему напечатал, что "пользователь получит сообщение об ошибке (404 страница не найдена)."?

Отлично!

in reply to:  64 ; comment:65 by alx, 10 months ago

Replying to Vladimir:

Тогда почему напечатал, что "пользователь получит сообщение об ошибке (404 страница не найдена)."?

Потому что это правда - когда обращаются по ссылке на несуществующую страницу, получают такое сообщение об ошибке.

in reply to:  65 ; comment:66 by Vladimir, 10 months ago

Replying to alx:

Replying to Vladimir:

Тогда почему напечатал, что "пользователь получит сообщение об ошибке (404 страница не найдена)."?

Потому что это правда - когда обращаются по ссылке на несуществующую страницу, получают такое сообщение об ошибке.

Но это же ссылка не на страницу в РЭ, а на страницу в Траке и в РЭ несколько подобных ссылок
(в РЭ-56 11 ссылок на https...)

Last edited 10 months ago by Vladimir (previous) (diff)

in reply to:  66 ; comment:67 by alx, 10 months ago

Replying to Vladimir:

Но это же ссылка не на страницу в РЭ, а на страницу в Траке и в РЭ несколько подобных ссылок.

И что? Не понимаю, в чем смысл этой реплики... У тебя по этому поводу есть какой-то вопрос? Тогда задай его. Я не телепат, на не заданные вопросы отвечать не умею. :) Ты не согласен со сказанным? Тогда возрази, приведи контр-аргументы...

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

in reply to:  67 ; comment:68 by Vladimir, 10 months ago

Replying to alx:

Replying to Vladimir:

Но это же ссылка не на страницу в РЭ, а на страницу в Траке и в РЭ несколько подобных ссылок.

И что? Не понимаю, в чем смысл этой реплики... У тебя по этому поводу есть какой-то вопрос? Тогда задай его. Я не телепат, на не заданные вопросы отвевать не умею. :) Ты не согласен со сказанным? Тогда во-рази, приведи контр-аргументы.

У меня в РЭ-56 все 11 ссылок типа https... открываются без ошибок, а у тебя с ошибками?

in reply to:  68 ; comment:69 by alx, 10 months ago

Replying to Vladimir:

У меня в РЭ-56 все 11 ссылок типа https... открываются без ошибок, а у тебя с ошибками?

Еще раз призываю тебя внимательнее читать то, что я пишу. У меня написано: "без этой статьи". Слово "без" должно было, по моей идее, навести читателя на мысль о том, что речь шла о случае отсутствия статьи.

in reply to:  69 comment:70 by Vladimir, 10 months ago

Replying to alx:

Replying to Vladimir:

У меня в РЭ-56 все 11 ссылок типа https... открываются без ошибок, а у тебя с ошибками?

Еще раз призываю тебя внимательнее читать то, что я пишу. У меня написано: "без этой статьи". Слово "без" должно было, по моей идее, навести читателя на мысль о том, что речь шла о случае отсутствия статьи.

Так в РЭ-56 эта статья открывается по указанной ссылке, т.е. доступна, можно считать, что есть :-)!
"http" в РЭ-56 встречается 21 раз - тексты по всем этим ссылкам тоже надо скопировать и вставить в РЭ? :-)

Last edited 10 months ago by Vladimir (previous) (diff)

in reply to:  59 ; comment:71 by san, 10 months ago

Replying to alx:

... Логично? По-моему да.
Надеюсь, что теперь я понятно объяснил логику.
Если функция есть - мы должны ее описать, чтобы дать пользователю возможность этой функцией пользоваться. А воспользуется он этой предоставленной нами возможностью или нет - это решать ему, а не нам.

Хм... И всё равно я не могу уловить грань...
Вот смотри: в плате SW-01 есть ОС, в которой есть утилита ping, например, или snmpd, или ещё много чего. В РЭ описания этих функции нет и если пользователю понадобится информация о работе snmpd (например как настроить SNMPv3), то мы пользователя отправим читать описание snmpd. А за это описание точно не может отвечать Vladimir.
Вот и с ссылкой на описание "расширенного Ethernet" я не вижу особых различий от ссылки на описание какого-нибудь snmpd.

Last edited 10 months ago by san (previous) (diff)

in reply to:  71 comment:72 by alx, 10 months ago

Replying to san:

Вот смотри. В плате SW-01 есть ОС в которой есть утилита ping, например. или snmpd или ещё много чего. В РЭ описания этих функции нет и если пользователю понадобится информация о работе snmpd (например как настроить SNMPv3), то мы пользователя отправим читать описание snmpd. А за это описание точно не может отвечать Vladimir.
Вот и с ссылкой на описание "расширенного Ethernet" я не вижу особых различий от ссылки на описание какого-нибудь snmpd.

Я не уверен, что правильно понял, какую-такую грань ты пытаешься уловить (было бы лучше, если бы ты прямо задал вопрос, а не ожидал, что я сам догадаюсь). Если ты хотел спросить, почему, по моему мнению, за описание программ ping и snmpd отвечает не Vladimir, а за sw:wiki:Ethernet - Vladimir, то это потому, что ping и snmpd - это не наша (не АДС) разработка, а swd - наша.

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

comment:73 by san, 10 months ago

Resolution: готово
Status: closedreopened

что ping и snmpd - это не наша (на АДС) разработка, а swd - наша

А, вот теперь понял где грань.

Давайте тогда вернёмся к предыдущему состоянию тикета и будем считать, что эта вкладка относится к пока ещё недокументированным функциям и когда-нибудь В.А. добавит её в описание.

Тикет открываю обратно)

in reply to:  73 comment:74 by Vladimir, 10 months ago

Replying to san:

что ping и snmpd - это не наша (на АДС) разработка, а swd - наша

А, вот теперь понял где грань.

Давайте тогда вернёмся к предыдущему состоянию тикета и будем считать, что эта вкладка относится к пока ещё недокументированным функциям и когда-нибудь В.А. добавит её в описание.

Тикет открываю обратно)

Т.е. тут надо добавить в РЭ 40 страниц текста из указанной ссылки, а ссылку переделать на Приложение-7?
Тогда как быть с остальными 20 ссылками типа http / https ?
Тоже будем добавлять их тексты в РЭ?

Last edited 10 months ago by Vladimir (previous) (diff)

comment:75 by san, 10 months ago

Т.е. тут надо добавить в РЭ

В итоге да, нужно добавить описание в РЭ, как и заявлено в тикете.

Тогда как быть с остальными 20 ссылками типа http / https ?
Тоже будем добавлять их тексты в РЭ?

В зависимости от того, что за информация находится по этим ссылкам.

in reply to:  75 comment:76 by Vladimir, 10 months ago

Replying to san:

Т.е. тут надо добавить в РЭ

В итоге да, нужно добавить описание в РЭ, как и заявлено в тикете.

А текст по этой ссылке уже достаточно отработан, чтобы его вставить в РЭ?

Тогда как быть с остальными 20 ссылками типа http / https ?
Тоже будем добавлять их тексты в РЭ?

В зависимости от того, что за информация находится по этим ссылкам.

Вот попался на глаза пункт со ссылками:

"5.10.5 Настройка пакета программ, установленных на плате MC-02.
Для администрирования и настройки SIP сервера на базе пакета Fusion PBX (Freeswitch) следует руководствоваться документацией на сайте https://docs.fusionpbx.com и частичным переводом http://adc-line.ru/pdf/FusionPBX_ru.pdf.
"

Текст по этим ссылкам тоже добавлять в РЭ ?

comment:77 by san, 10 months ago

А текст по этой ссылке уже достаточно отработан, чтобы его вставить в РЭ?

Не могу сказать, там довольно большой объём информации, я сам ещё до конца не разобрался как всё работает.

Текст по этим ссылкам тоже добавлять в РЭ ?

Нет

in reply to:  77 comment:78 by Vladimir, 10 months ago

Replying to san:

А текст по этой ссылке уже достаточно отработан, чтобы его вставить в РЭ?

Не могу сказать, там довольно большой объём информации, я сам ещё до конца не разобрался как всё работает.

Т.е. пока рано вставлять в РЭ, хотя по этому тикету уже 77 комментов и пошёл 7-й год :-)

Это похоже на шутку "Гнать зайца дальше!" :-)

in reply to:  77 comment:79 by Vladimir, 8 months ago

Replying to san:

А текст по этой ссылке уже достаточно отработан, чтобы его вставить в РЭ?

Не могу сказать, там довольно большой объём информации, я сам ещё до конца не разобрался как всё работает.

Текст по этим ссылкам тоже добавлять в РЭ ?

Нет

В опубликованном РЭ-57 уже была вставлена фраза:
"Описание вкладки Ethernet в режиме полная доступно по ссылке: https://trac.adc-line.ru/sw-01/wiki/Ethernet (расширенные настройки)."

Так пока и оставим?
Этот тикет закрыть или оставить "на память"?
Или полный текст описания по ссылке уже вставить в РЭ-58?
Текст по ссылке добавит в РЭ порядка 40 страниц и будет порядка 470 страниц.
Если вставлять эти 40 страниц в РЭ, то в Приложение?

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

in reply to:  19 ; comment:80 by Vladimir, 7 months ago

Replying to alx:

Replying to san:

Создал wiki/Ethernet для описания полной конфигурации Ethernet, добавил туда описание колонки Pause, предлагаю по возможности добавлять на эту страничку описание настроек полной конфигурации ethernet.

Не понимаю, в чем смысл иметь дубликат того, что описано в РЭ. Ты сам всегда говорил, что это нерационально - каждый раз, когда что-то изменится в аппаратуре, придется изменять описание сразу в двух местах - в РЭ и в wiki...

Вот поэтому я и предлагаю обновлять и добавлять информацию истинным Разработчикам -
они не могут ничего добавить в РЭ, а вот дополнить своё вики они могут запросто в любой момент
и без разработчика РЭ, который часто отстаёт от новых дополнений на длительное время.
Первично создаётся и редактируется всё-таки Вики, так зачем тогда копировать это ещё и в РЭ то,
что доступно любому юзеру в 1 клик на ссылку вики в РЭ?
К тому же, эта подробная информация, наверное, требуется только одному продвинутому юзеру из тысячи обычных юзеров.
Моё решение и предложение: оставить в РЭ ссылку на вики, которую будут редактировать знатоки
(я могу при добавлении в РЭ чего-то из вики добавить свои ошибки).
В любом случае всегда лучше читать первоисточник (вики) от программистов, а не пересказ этого "незнайками" :-)
В связи с этим, если нет существенных возражений, я хотел бы закрыть этот тикет.
Вики можно улучшать хоть каждый день, а отслеживать это в РЭ гораздо труднее.

in reply to:  80 ; comment:81 by alx, 7 months ago

Replying to Vladimir:

Вот поэтому я и предлагаю обновлять и добавлять информацию истинным Разработчикам -
они не могут ничего добавить в РЭ, а вот дополнить своё вики они могут запросто в любой момент
и без разработчика РЭ, который часто отстаёт от новых дополнений на длительное время.

Вообще-то именно в статью sw:wiki:Ethernet не могут - право ее редактирования есть только у тебя (см. comment:61, где я об этом тебе писал 3 месяца назад).

Первично создаётся и редактируется всё-таки Вики, так зачем тогда копировать это ещё и в РЭ то,
что доступно любому юзеру в 1 клик на ссылку вики в РЭ?

Мне кажется удобным для читателя, когда вся необходимая для эксплуатации изделия информация находится в одном месте (одном документе). Ведь и ты сам почему-то раньше именно так и делал - переписывал описания каких-то составляющих узлов аппаратуры (например канальных окончаний платы VE-01) в один общий документ. И только в comment:45 впервые почему-то решил сделать по-другому, чем очень меня удивил...

Моё решение и предложение: оставить в РЭ ссылку на вики, которую будут редактировать знатоки
(я могу при добавлении в РЭ чего-то из вики добавить свои ошибки).

Об этом своем решении ты уведомил нас еще 4 месяца назад в comment:45. Я принял твое решение к сведению. В чем состоит твое предложение и кому именно оно адресовано, я не понял...

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

in reply to:  81 ; comment:82 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

Вот поэтому я и предлагаю обновлять и добавлять информацию истинным Разработчикам -
они не могут ничего добавить в РЭ, а вот дополнить своё вики они могут запросто в любой момент
и без разработчика РЭ, который часто отстаёт от новых дополнений на длительное время.

Вообще-то именно в статью sw:wiki:Ethernet не могут - право ее редактирования есть только у тебя (см. comment:61, где я об этом тебе писал 3 месяца назад).

Это ты сделал зря: право редактировать должны иметь только те специалисты,
которые глубоко знают и понимают эту тему, например, это alex, san, mixyil1.1,
а я в этой теме новичок и могу добавить по незнанию вопроса только ошибки, т.е. испортить описание.
Так что меня лучше исключить из числа редакторов wiki - я эту тему почти совсем не знаю
и за всю жизнь не записал в wiki ни одной строчки и даже ни одной буквы и вряд ли буду это делать :-)

Первично создаётся и редактируется всё-таки Вики, так зачем тогда копировать это ещё и в РЭ то,
что доступно любому юзеру в 1 клик на ссылку вики в РЭ?

Мне кажется удобным для читателя, когда вся необходимая для эксплуатации изделия информация находится в одном месте (одном документе). Ведь и ты сам почему-то раньше именно так и делал - переписывал описания каких-то составляющих узлов аппаратуры (например канальных окончаний платы VE-01) в один общий документ. И только в comment:45 впервые почему-то решил сделать по-другому, чем очень меня удивил...

Ты, возможно, забыл, что в комменте 45 я это сделал с подачи от САН:
"САН сказал, что для РЭ достаточно разместить только ссылку
​wiki/Ethernet для описания полной конфигурации Ethernet",
и при этом он не считает меня автором текста по этой ссылке,
и не считает, что если я размещаю ссылку, то я же и должен редактировать текст по этой ссылке."

Моё решение и предложение: оставить в РЭ ссылку на вики, которую будут редактировать знатоки
(я могу при добавлении в РЭ чего-то из вики добавить свои ошибки).

Об этом своем решении ты уведомил нас еще 4 месяца назад в comment:45. Я принял твое решение к сведению. В чем состоит твое предложение и кому именно оно адресовано, я не понял...

Я повторил это предложение для тех, кто хочет вставить полный текст 40 страниц из Вики в РЭ,
т.к. рано или поздно копия в РЭ не будет соответствовать тексту в Вики
(я не всегда могу быстро отследить изменения от Знатоков в Вики),
а корректировать в двух местах нет смысла. К тому же, информация о полной конфигурации,
на мой взгляд, требуется крайне редко для очень узкого круга специалистов,
а кроме того, в РЭ уже есть несколько ссылок на Вики и другие источники -
если всё это включить в РЭ, то РЭ будет, возможно, уже 1000 страниц, а то и больше...

in reply to:  82 ; comment:83 by alx, 7 months ago

Replying to Vladimir:

Это ты сделал зря: право редактировать должны иметь только те специалисты,
которые глубоко знают и понимают эту тему, например, это alex, san, mixyil1.1,
а я в этой теме новичок и могу добавить по незнанию вопроса только ошибки, т.е. испортить описание.

Мне кажется логичным и правильным, когда право редактирования РЭ (частью которого является данная статья) имеет только разработчик РЭ. Твои вопросы в comment:57 я понял как просьбу сделать так, чтобы никто кроме тебя не мог эту статью редактировать (что посчитал логичным и естественным). Мне бы, например, не понравилось, если бы документ, разработчиком которого я являюсь и за который отвечаю, могли изменить другие люди...

Так что меня лучше исключить из числа редакторов wiki - я эту тему почти совсем не знаю
и за всю жизнь не записал в wiki ни одной строчки и даже ни одной буквы и вряд ли буду это делать :-)

Это ты не по адресу - не я назначаю разработчиков в нашей компании.

Ты, возможно, забыл, что в комменте 45 я это сделал с подачи от САН:

Мне это совершенно не важно. Я уважаю твое решение независимо от того, сделано ли оно с чьей-либо подачи, и если да, то с чьей.

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

in reply to:  83 ; comment:84 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

Это ты сделал зря: право редактировать должны иметь только те специалисты,
которые глубоко знают и понимают эту тему, например, это alex, san, mixyil1.1,
а я в этой теме новичок и могу добавить по незнанию вопроса только ошибки, т.е. испортить описание.

Мне кажется логичным и правильным, когда право редактирования РЭ (частью которого является данная статья) имеет только разработчик РЭ. Твои вопросы в comment:57 я понял как просьбу сделать так, чтобы никто кроме тебя не мог эту статью редактировать.

В таком случае, ты закрыл эту статью от каких-либо изменений, исправлений, улучшений,
т.к. я это не могу сделать - просто не знаю что и как там надо менять,
а доступ к редактированию теми, кто реально знает и может это делать ты закрыл.
Это плохо для всех ...

Ты неправильно понял мой текст в Комм-57: статью в Вики сочинял и печатал не я,
т.е. я не автор статьи, поэтому я имел ввиду истинного Автора, т.е. САН или тебя.
Редактировать в этой статье что-либо я тоже не могу, т.к. не знаю эту тему.

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

Так что меня лучше исключить из числа редакторов wiki - я эту тему почти совсем не знаю
и за всю жизнь не записал в wiki ни одной строчки и даже ни одной буквы и вряд ли буду это делать :-)

Это ты не по адресу - не я назначаю разработчиков в нашей компании.

Речь шла об Авторе-разработчике статьи, а не РЭ!

Last edited 7 months ago by Vladimir (previous) (diff)

in reply to:  83 ; comment:85 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

Это ты сделал зря: право редактировать должны иметь только те специалисты,
которые глубоко знают и понимают эту тему, например, это alex, san, mixyil1.1,
а я в этой теме новичок и могу добавить по незнанию вопроса только ошибки, т.е. испортить описание.

Мне кажется логичным и правильным, когда право редактирования РЭ (частью которого является данная статья) имеет только разработчик РЭ.

Вот последний пример: при описании МС-03 есть ссылка: http://adc-line.ru/pdf/FusionPBX_ru.pdf

  • это примерно 150 страниц текста, который я вижу первый раз в жизни и ты считаешь,

что я теперь автор и этого текста? - это абсурд: я не мог быть и не могу стать Автором этого текста
только по тому, что дал на него ссылку :-)

comment:86 by san, 7 months ago

Мне кажется логичным и правильным, когда право редактирования РЭ (частью которого является данная статья) имеет только разработчик РЭ.

На мой взгляд, тут логическая ошибка, т.к. эта статья не является частью РЭ. С таким же успехом Vladimir мог сослаться на фрагмент даташита и тот тоже бы не стал частью РЭ. Но насколько я помню, мы с alx уже устно обсуждали это и так и не пришли к пониманию :)

Предлагаю два варианта решения этой ситуации:

  1. Убрать из РЭ ссылку на эту статью и вернуть права редактирования статьи alx
  2. Добавить в РЭ информацию из статьи и вернуть права редактирования статьи alx
Last edited 7 months ago by san (previous) (diff)

in reply to:  84 comment:87 by alx, 7 months ago

Replying to Vladimir:

В таком случае, ты закрыл эту статью от каких-либо изменений, исправлений, улучшений,
т.к. я это не могу сделать - просто не знаю что и как там надо менять,

??? В части "что" я не понял... Ты знаешь, что в этой статье надо что-то изменить, но не знаешь, что именно? Как это возможно? Откуда, в таком случае, ты знаешь, что что-то надо изменить? Может и не надо ничего изменять? :)

По поводу "как" готов подсказать. Внизу страницы со статьей есть кнопка "Редактировать эту страницу". Нажми ее. Откроется редактор - точно такой же как тот, в котором ты редактируешь, например, комментарии к тикетам. Там можно внести необходимые изменения. Внизу есть полезные кнопки "Предварительный просмотр страницы", "Просмотр изменений" и "Отправить изменения". Последняя из них сохраняет сделанные изменения.

Также рекомендую обратить внимание на чекбокс "Редактировать бок о бок" (вверху справа). При его отметке в процессе редактирования справа сразу отображаются изменения, что довольно удобно.

Редактировать в этой статье что-либо я тоже не могу, т.к. не знаю эту тему.

Но ведь ту часть РЭ, которая в документе PDF ты как-то редактируешь! Почему не можешь точно так же редактировать статью wiki?

Это ты не по адресу - не я назначаю разработчиков в нашей компании.

Речь шла об Авторе-разработчике статьи, а не РЭ!

В моем понимании, это одно и то же, так как данная статья - часть РЭ. РЭ сейчас состоит из двух частей - документа PDF и этой статьи wiki. Следовательно, и разработчик у них один и тот же - это разработчик РЭ, то есть ты. Пока кто-нибудь из имеющих соответствующие полномочия менеджеров не назначит другого разработчика. По-моему так...

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

in reply to:  85 ; comment:88 by alx, 7 months ago

Replying to Vladimir:

Вот последний пример: при описании МС-03 есть ссылка: http://adc-line.ru/pdf/FusionPBX_ru.pdf

  • это примерно 150 страниц текста, который я вижу первый раз в жизни и ты считаешь,

что я теперь автор и этого текста?

Нет, не считаю. Я понятия не имею, кто автор этого текста.

in reply to:  86 comment:89 by alx, 7 months ago

Replying to san:

На мой взгляд, тут логическая ошибка, т.к. эта статья не является частью РЭ.

Почему же не является, если она описывает порядок эксплуатации нашей аппаратуры, и это единственное место, где пользователь может об этом узнать?

Предлагаю два варианта решения этой ситуации:

Не понял, кому ты это предлагаешь. Мне?

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

in reply to:  86 comment:90 by Vladimir, 7 months ago

Replying to san:

Мне кажется логичным и правильным, когда право редактирования РЭ (частью которого является данная статья) имеет только разработчик РЭ.

Предлагаю два варианта решения этой ситуации:

  1. Убрать из РЭ ссылку на эту статью и вернуть права редактирования статьи alx

Убрать могу, но тогда надо удалить всю фразу в
"6.2.3 Вкладка Ethernet - настройка коммутатора платы SW-01":
"... Описание вкладки Ethernet в режиме полная доступно по ссылке:
https://trac.adc-line.ru/sw-01/wiki/Ethernet (расширенные настройки)."
В этом случае юзеры должны будут делать настройку по своему разумению
или недоразумению и будут звонить в техподдержку, которая будет высылать им ссылку.
Хорошо ли это?

  1. Добавить в РЭ информацию из статьи и вернуть права редактирования статьи alx

Тогда будет 2 одинаковых текста (в Вики и в РЭ), которые надо надо не забывать
редактировать одновременно - это бывает не всегда возможно:
я могу и не знать об изменениях в Вики (могу быть в отпуске, на больничном, занят срочным делом, забыть).

А может быть, будем считать этот тикет, как рекомендация, а в РЭ оставим ссылку?
Ну, или закроем с резолюцией "Не будем делать" ?

"Так быть или не быть" подобным ссылкам в РЭ?
или будем все тексты всех ссылок печатать в РЭ, включая "​http://adc-line.ru/pdf/FusionPBX_ru.pdf"
на 150 страниц текста и все другие? На мой взгляд, это абсурд :-)

in reply to:  83 ; comment:91 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:
Мне кажется логичным и правильным, когда право редактирования РЭ (частью которого является данная статья)
имеет только разработчик РЭ.

ИМХО, частью РЭ эта статья станет только после того, как я вставлю из Вики текст этой статьи в РЭ,
а сейчас автором этой статьи является САН или ты, или другой знаток этой темы
(разработчик РЭ собирает информацию от Разработчиков харда и софта, а также может немного редактировать
с согласия Авторов харда и софта, чтобы не исказить смысл и не упустить важные детали:
разработчик РЭ не может подробно знать всё обо всех изделиях, которые входят в РЭ).

Мне бы, например, не понравилось, если бы документ, разработчиком которого я являюсь и за который отвечаю, > > могли изменить другие люди...

А если бы ты вставил в свой документ тексты других авторов, которые могут знать тему лучше и точнее тебя,
то ты бы тоже не разрешил Авторам текстов вносить изменения в лучшую сторону? :-)

Так что меня лучше исключить из числа редакторов wiki - я эту тему почти совсем не знаю!

Зачем присваивать авторство тому, кто не придумал, не сочинил текст, а вставил чужой текст других Авторов?
Вот ты бы что предпочёл читать - авторский первоисточник, или пересказ человека,
который слабо владеет темой статьи?

Last edited 7 months ago by Vladimir (previous) (diff)

in reply to:  91 ; comment:92 by alx, 7 months ago

Replying to Vladimir:

ИМХО, частью РЭ эта статья станет только после того, как я вставлю из Вики текст этой статьи в РЭ,

Как странно... А что, в таком случае, ты называешь "РЭ"?

А если бы ты вставил в свой документ тексты других авторов, которые могут знать тему лучше и точнее тебя,
то ты бы тоже не разрешил Авторам текстов вносить изменения в лучшую сторону? :-)

Я бы не согласился взять на себя ответственность за текст, который может изменить кто-либо без моего ведома и помимо моей воли. В какую бы сторону эти изменения ни были направлены.

Зачем присваивать авторство тому, кто не придумал, не сочинил текст, а вставил чужой текст других Авторов?

Я ничего об этом не знаю. Я ничьего авторства никому не присваивал.

in reply to:  91 comment:93 by alx, 7 months ago

Replying to Vladimir:

Вот ты бы что предпочёл читать - авторский первоисточник, или пересказ человека,
который слабо владеет темой статьи?

Это зависит от обстоятельств.

in reply to:  88 ; comment:94 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

Вот последний пример: при описании МС-03 есть ссылка: http://adc-line.ru/pdf/FusionPBX_ru.pdf

  • это примерно 150 страниц текста, который я вижу первый раз в жизни и ты считаешь,

что я теперь автор и этого текста?

Нет, не считаю. Я понятия не имею, кто автор этого текста.

Но эта же ссылка находится в РЭ, а ты считаешь, что если ссылка в РЭ, то я и есть автор текста :-)
Например, текст обсуждаемой ссылки "​https://trac.adc-line.ru/sw-01/wiki/Ethernet" ты приписываешь мне,
а на самом деле Автором является САН, а ты, возможно соавтор :-)

in reply to:  94 ; comment:95 by alx, 7 months ago

Replying to Vladimir:

Я понятия не имею, кто автор этого текста.

Но эта же ссылка находится в РЭ, а ты считаешь, что если ссылка в РЭ, то я и есть автор текста :-)

Не надо приписывать мне мнение (тем более такое глупое), которого я не высказывал. Это не смешно.

Например, текст обсуждаемой ссылки "​https://trac.adc-line.ru/sw-01/wiki/Ethernet" ты приписываешь мне,

Это ложь.

in reply to:  92 ; comment:96 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

ИМХО, частью РЭ эта статья станет только после того, как я вставлю из Вики текст этой статьи в РЭ,

Как странно... А что, в таком случае, ты называешь "РЭ"?

Это текст написанный в черновике или даже сказанный устно авторами харда/софта,
отредактированный разработчиком документа РЭ и согласованный с Авторами харда/софта,
а также ссылки на тексты других авторов по теме РЭ.

А если бы ты вставил в свой документ тексты других авторов, которые могут знать тему лучше и точнее тебя,
то ты бы тоже не разрешил Авторам текстов вносить изменения в лучшую сторону? :-)

Я бы не согласился взять на себя ответственность за текст, который может изменить кто-либо без моего ведома и помимо моей воли. В какую бы сторону эти изменения ни были направлены.

А если бы твой текст оказался неточным, ошибочным по мнению истинных Авторов?

Зачем присваивать авторство тому, кто не придумал, не сочинил текст, а вставил чужой текст других Авторов?

Я ничего об этом не знаю. Я ничьего авторства никому не присваивал.

Так ты же считаешь, что если я вставил ссылку других авторов в моё РЭ, то я и есть Автор всего, что есть в РЭ!

in reply to:  95 ; comment:97 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

Я понятия не имею, кто автор этого текста.

Но эта же ссылка находится в РЭ, а ты считаешь, что если ссылка в РЭ, то я и есть автор текста :-)

Не надо приписывать мне мнение (тем более такое глупое), которого я не высказывал. Это не смешно.

Например, текст обсуждаемой ссылки "​https://trac.adc-line.ru/sw-01/wiki/Ethernet" ты приписываешь мне,

Это ложь.

Я так понял из твоих ответов про эту ссылку, которая уже давно в РЭ,
если я ошибся, то извини.
Тогда почему ты отрицаешь возможность вставлять в РЭ текст других авторов,
да ещё и закрыл им доступ для редактирования своих собственных текстов?
Открой доступ для САН и для себя, ну и для Макаревича - я им доверяю в этом вопросе больше, чем себе!

in reply to:  96 ; comment:98 by alx, 7 months ago

Replying to Vladimir:

А что, в таком случае, ты называешь "РЭ"?

Это текст написанный в черновике или даже сказанный устно авторами харда/софта,
отредактированный разработчиком документа РЭ и согласованный с Авторами харда/софта,
а также ссылки на тексты других авторов по теме РЭ.

Обрати внимание, что у тебя возникла рекурсия: объясняя, что такое РЭ, ты используешь понятие РЭ. Получается, чтобы понять, что такое РЭ, надо сначала понять, что такое РЭ! :) Из этого факта я делаю вывод, что ты не можешь ясно сформулировать, что такое РЭ.

А если бы твой текст оказался неточным, ошибочным по мнению истинных Авторов?

Не понимаю вопрос. Что "а если"? Ты здесь написал некое вводное условие (что по мнению кого-то мой текст неточен) и поставил после него знак вопроса. Но самого-то вопроса нет! Насколько я понимаю, после вводного условия должен быть сформулирован собственно вопрос, например: "Если бы твой текст оказался неточным, ошибочным по мнению истинных Авторов, стал ты бы плакать?". Похоже, что собственно вопрос ты сформулировать забыл... :)

Так ты же считаешь, что если я вставил ссылку других авторов в моё РЭ, то я и есть Автор всего, что есть в РЭ!

Неправда. Я так не считаю.

Я вижу, что тебя мое реальное мнение не интересует, тебе интереснее придумывать мое мнение зам меня. Я не могу тебе этого запретить, ты свободный человек. Но участвовать в подобном разговоре я отказываюсь.

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

in reply to:  97 ; comment:99 by alx, 7 months ago

Replying to Vladimir:

Я так понял из твоих ответов про эту ссылку, которая уже давно в РЭ,
если я ошибся, то извини.

Извиняю.

Я тоже прошу прощения, в предыдущем комментарии я погорячился, написав, что отказываюсь от дальнейшего разговора. Это неконструктивная позиция, которая не способствует устранению недопонимания. Постараюсь продолжать дискуссию.

Тогда почему ты отрицаешь возможность вставлять в РЭ текст других авторов,

Извинился за одну приписанную мне выдумку и тут же приписал мне другую! :)

Я не знаю, почему я отрицаю возможность вставлять в РЭ текст других авторов. Я только сейчас с большим удивлением узнал от тебя о том, что я, оказывается, ее отрицаю. :)

да ещё и закрыл им доступ для редактирования своих собственных текстов?

Я уже объяснял, почему я закрыл возможность редактирования для всех кроме тебя. Потому что я понял написанное тобой в comment:57 как выражение (совершенно понятной) обеспокоенности тем, что кто-то другой без твоего ведома и помимо твоей воли может изменять текст, за который отвечаешь ты. Ты спрашивал, как защитить статью от изменения. Я понял это как просьбу, и выполнил ее (ты сам не смог бы этого сделать, так как не можешь менять права доступа, это может делать только администратор).

Открой доступ для САН и для себя, ну и для Макаревича - я им доверяю в этом вопросе больше, чем себе!

Открыл.

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

in reply to:  99 ; comment:100 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

Тогда почему ты отрицаешь возможность вставлять в РЭ текст других авторов,

Извинился на одну приписанную мне выдумку и тут же приписал мне другую! :)

Моя фраза оказалась незаконченной: я имел ввиду вставку ссылок с текстом других авторов,
например, "​​https://trac.adc-line.ru/sw-01/wiki/Ethernet" - чем тебе не нравится такая форма подачи дополнительной информации для продвинутых юзеров?

Я не знаю, почему я отрицаю возможность вставлять в РЭ текст других авторов. Я только сейчас с большим удивлением узнал о тебя о том, что я, оказывается, ее отрицаю. :)

Как я понял, ты сопротивляешься вставке в РЭ ссылки "​​https://trac.adc-line.ru/sw-01/wiki/Ethernet"
и хочешь непременно скопировать этот авторский текст от САН в РЭ...

Открой доступ для САН и для себя, ну и для Макаревича - я им доверяю в этом вопросе больше, чем себе!

Открыл.

Вот Спасибо - теперь, имхо, нет препятствий оставить ссылку в РЭ - она всегда будет актуальная
и уже не обязательно копировать текст по этой ссылке в РЭ, т.к. Авторы могут его изменить в Вики.

Last edited 7 months ago by Vladimir (previous) (diff)

comment:101 by Vladimir, 7 months ago

Resolution: не будем делать
Status: reopenedclosed

С учётом Комм-43
"...В таком случае, нет, ты не обязан редактировать тексты по всем этим 16 ссылкам, так как они не являются частями РЭ."
и комм-49
"Уточню что в устном разговоре речь шла о закрытии тикета с резолюцией "не будем делать" а не "готово"."

закрываю этот тикет с резолюцией "не будем делать",
т.е. оставим авторский первоисточник текста по ссылке на Вики, который авторы и будут редактировать,
а юзеры всегда будут видеть актуальный текст.

in reply to:  100 ; comment:102 by alx, 7 months ago

Replying to Vladimir:

Моя фраза оказалась незаконченной: я имел ввиду вставку ссылок с текстом других авторов,
например, "​​https://trac.adc-line.ru/sw-01/wiki/Ethernet" - чем тебе не нравится такая форма подачи дополнительной информации для продвинутых юзеров?

Не знаю, чем не нравится. Я только сейчас от тебя узнал, что она мне, оказывается, не нравится... Ты мне скажи, чем мне не нравится, раз ты сегодня мне мои мнения по различным вопросам сообщаешь... :)

in reply to:  102 comment:103 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

Моя фраза оказалась незаконченной: я имел ввиду вставку ссылок с текстом других авторов,
например, "​​https://trac.adc-line.ru/sw-01/wiki/Ethernet" - чем тебе не нравится такая форма подачи дополнительной информации для продвинутых юзеров?

Не знаю, чем не нравится. Я только сейчас от тебя узнал, что она мне, оказывается, не нравится... Ты мне скажи, чем мне не нравится, раз ты сегодня мне мои мнения по различным вопросам сообщаешь... :)

Если ты говоришь, что текст по этой ссылке надо скопировать и вставить в РЭ,
а ссылку на Вики можно вообще исключить из РЭ, то, видимо, тебе не нравится подача дополнительной информации в виде ссылок на общедоступные источники информации...

in reply to:  98 ; comment:104 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

А что, в таком случае, ты называешь "РЭ"?

Это текст написанный в черновике или даже сказанный устно авторами харда/софта,
отредактированный разработчиком документа РЭ и согласованный с Авторами харда/софта,
а также ссылки на тексты других авторов по теме РЭ.

Обрати внимание, что у тебя возникла рекурсия: объясняя, что такое РЭ, ты используешь понятие РЭ. Получается, чтобы понять, что такое РЭ, надо сначала понять, что такое РЭ! :) Из этого факта я делаю вывод, что ты не можешь ясно сформулировать, что такое РЭ.

Сейчас на любой вопрос есть любой ответ в Интернете, в частности, в Википедии:
"Руководство по эксплуатации — документ или интерактивное электронное приложение, содержащие сведения о конструкции, принципе действия, характеристиках (свойствах) изделия, его составных частях и указания, необходимые для правильной и безопасной эксплуатации изделия (использования по назначению, технического обслуживания, текущего ремонта, хранения и транспортирования) и оценок его технического состояния при определении необходимости отправки изделия в ремонт, а также сведения по утилизации изделия или его составных частей".

Я это тоже подразумевал, однако, если разработчик РЭ не является разработчиком описываемого харда и софта, то он должен получить подробные сведения и важные формулировки в черновике или устно у Авторов харда и софта, чтобы изложить эти сведения в РЭ и согласовать с Авторами харда/софта, а при отсутствии подробной информации дать ссылки на открытые и общедоступные источники. Что я и стараюсь делать.

А если бы твой текст оказался неточным, ошибочным по мнению истинных Авторов?

Не понимаю вопрос. Что "а если"?

... то ты бы, как Автор РЭ, всё равно настаивал бы на своём тексте?
Скорее нет: ты бы выслушал аргументы, уточнения, привёл свои доводы
и записал бы согласованную редакцию текста - что я и пытаюсь делать.
Но самый короткий путь к истине - это эскизное изложение для РЭ авторов харда и софта,
или других Знатоков, которые принимали участие в обсуждениях разработки изделия,
уже работали с этим изделием (настройка, тестирование, пуско-наладка - у меня-то этого нет!).

Так ты же считаешь, что если я вставил ссылку других авторов в моё РЭ, то я и есть Автор всего, что есть в РЭ!

Неправда. Я так не считаю.

Мне так ошибочно показалось, что я, якобы, должен отвечать за правильность чужого текста опытных специалистов,
редактировать его, причём единолично и ты даже закрыл доступ к тексту по ссылке всем, кроме меня:
"Вообще-то именно в статью ​sw:wiki:Ethernet не могут - право ее редактирования есть только у тебя)."
Получается, что истинным авторам статьи ты доступ закрыл, но оставил доступ к изменениям тому,
кто недостаточно хорошо знает эту тему - хорошо ли это было?
К счастью, ты уже открыл доступ к статье Авторам текста и Знатокам этой темы!
И теперь текст по ссылке всегда будет актуальным и авторским!

Я вижу, что тебя мое реальное мнение не интересует

Очень интересует - ты же Автор, ну, или соавтор, Знаток описываемого харда/софта!
Что бы я мог без тебя напечатать в РЭ?!

in reply to:  104 ; comment:105 by alx, 7 months ago

Replying to Vladimir:

"Руководство по эксплуатации — документ или интерактивное электронное приложение, содержащие сведения о конструкции, принципе действия, характеристиках (свойствах) изделия, его составных частях и указания, необходимые для правильной и безопасной эксплуатации изделия (использования по назначению, технического обслуживания, текущего ремонта, хранения и транспортирования) и оценок его технического состояния при определении необходимости отправки изделия в ремонт, а также сведения по утилизации изделия или его составных частей".

Спасибо. А теперь, исходя из этого определения, объясни мне, пожалуйста, почему статья sw:wiki:Ethernet частью РЭ не являлась (когда действовала редакция РЭ-56), а файл http://adc-line.ru/pdf/mc04-dsl-3u-re.pdf - являлся. Я этого не понимаю...

И еще одно соображение. Ты говоришь, что статья, в которой описано, как настраивать целый ряд функций ethernet платы SW-01 и их настройка, частью РЭ не являлась. Но если так, то получается, что в РЭ эти функции не описаны (а решение о том, что их описывать не надо, на тот момент принято еще не было!)! Следовательно, РЭ, разработчиком которого ты являешься и за которое отвечаешь, было неполным...

А если бы твой текст оказался неточным, ошибочным по мнению истинных Авторов?

Не понимаю вопрос. Что "а если"?

... то ты бы, как Автор РЭ, всё равно настаивал бы на своём тексте?

Если бы считал его правильным - то да, все равно настаивал бы. Если бы считал неправильным - то нет, не настаивал бы, а наоборот, изменил бы его на тот, который считал бы правильным.

Получается, что истинным авторам статьи ты доступ закрыл, но оставил доступ к изменениям тому,
кто недостаточно хорошо знает эту тему - хорошо ли это было?

Да, это было хорошо и правильно, и выше я уже объяснял почему.

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

in reply to:  105 ; comment:106 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:
Спасибо. А теперь, исходя из этого определения, объясни мне, пожалуйста, почему статья sw:wiki:Ethernet частью РЭ не являлась (когда действовала редакция РЭ-56),

В тексте РЭ-56 было записано точно также, как и в РЭ-58:
"Описание вкладки Ethernet в режиме полная доступно по ссылке: https://trac.adc-line.ru/sw-01/wiki/Ethernet (расширенные настройки).", а раз уж это реально было в РЭ-56, то статья являлась и сейчас является частью РЭ, как дополнительная информация для продвинутых юзеров.

а файл http://adc-line.ru/pdf/mc04-dsl-3u-re.pdf - являлся. Я этого не понимаю...

Этот файл и есть само РЭ, включая записанную в нём ссылку на статью.
По этому вопросу в РЭ-56 и в РЭ-58 всё одинаково.

И еще одно соображение. Ты говоришь, что статья, в которой описано, как настраивать целый ряд функций ethernet платы SW-01 и их настройка, частью РЭ не являлась. Но если так, то получается, что в РЭ эти функции не описаны (а решение о том, что их описывать не надо, на тот момент принято еще не было!)! Следовательно, РЭ, разработчиком которого ты являешься и за которое отвечаешь, было неполным...

РЭ полное с учётом этой статьи и других ссылок на другие статьи.

Получается, что истинным авторам статьи ты доступ закрыл, но оставил доступ к изменениям тому,
кто недостаточно хорошо знает эту тему - хорошо ли это было?

Да, это было хорошо и правильно, и выше я уже объяснял почему.

А разве хорошо, когда авторскую статью будет редактировать не Автор или Знаток,
а "Незнайка" по своему недоразумению в этом вопросе?

Last edited 7 months ago by Vladimir (previous) (diff)

in reply to:  106 ; comment:107 by alx, 7 months ago

Replying to Vladimir:

Спасибо. А теперь, исходя из этого определения, объясни мне, пожалуйста, почему статья sw:wiki:Ethernet частью РЭ не являлась (когда действовала редакция РЭ-56),

В тексте РЭ-56 было записано точно также, как и в РЭ-58:
"Описание вкладки Ethernet в режиме полная доступно по ссылке: https://trac.adc-line.ru/sw-01/wiki/Ethernet (расширенные настройки).", а раз уж это реально было в РЭ-56, то статья являлась и сейчас является частью РЭ, как дополнительная информация для продвинутых юзеров.

а файл http://adc-line.ru/pdf/mc04-dsl-3u-re.pdf - являлся. Я этого не понимаю...

Этот файл и есть само РЭ, включая записанную в нём ссылку на статью.
По этому вопросу в РЭ-56 и в РЭ-58 всё одинаково.

??? Ты считаешь, что написанное тобой отвечает на вопрос, почему один из двух названных документов является частью РЭ, а другой - нет? Я в написанном тобой ответа на этот вопрос не вижу...

Одни документ не является частью РЭ, потому что в редакции 56 другого документа было записано точно так же, как и в его же редакции 58? Серьезно? Прости, но я в таком объяснении не вижу никакой логики...

И еще одно соображение. Ты говоришь, что статья, в которой описано, как настраивать целый ряд функций ethernet платы SW-01 и их настройка, частью РЭ не являлась. Но если так, то получается, что в РЭ эти функции не описаны (а решение о том, что их описывать не надо, на тот момент принято еще не было!)! Следовательно, РЭ, разработчиком которого ты являешься и за которое отвечаешь, было неполным...

РЭ полное с учётом этой статьи и других ссылок на другие статьи.

Ты сам себе противоречишь. Если ты утверждаешь, что данная статься не является частью РЭ, то тогда ты и не можешь учитывать ее при оценке полноты РЭ. Иначе получаются "двойные стандарты".

Да, это было хорошо и правильно, и выше я уже объяснял почему.

А разве хорошо,
когда авторскую статью будет редактировать на Автор или Знаток,
а "Незнайка" по своему недоразумению в этом вопросе?

Я уже ответил на этот вопрос. Ты мой ответ процитировал, и тут же снова задал тот же вопрос. Зачем? Какой в этом смысл? Ты думаешь, что если много раз повторить вопрос, ответ на него изменится? :) Нет, ответ не изменился. Я по-прежнему считаю, что это хорошо и правильно, когда текст редактирует тот и только тот, кто за него отвечает.

in reply to:  107 ; comment:108 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

В тексте РЭ-56 было записано точно также, как и в РЭ-58:
"Описание вкладки Ethernet в режиме полная доступно по ссылке: https://trac.adc-line.ru/sw-01/wiki/Ethernet (расширенные настройки).", а раз уж это реально было в РЭ-56, то статья являлась и сейчас является частью РЭ, как дополнительная информация для продвинутых юзеров.

а файл http://adc-line.ru/pdf/mc04-dsl-3u-re.pdf - являлся. Я этого не понимаю...

Этот файл и есть само РЭ, включая записанную в нём ссылку на статью.
По этому вопросу в РЭ-56 и в РЭ-58 всё одинаково.

??? Ты считаешь, что написанное тобой отвечает на вопрос, почему один из двух названных документов является частью РЭ, а другой - нет? Я в написанном тобой ответа на этот вопрос не вижу...

А разве в РЭ категорически запрещено давать ссылки на дополнительные источники информации,
которые более подробно описывают возможные действия?
Если ссылка помещена в текст РЭ, то это значит, что разработчик РЭ, с согласия Автора текста по этой ссылке (это САН - начальник отдела разработок и ответственный за качество РЭ - как он скажет так я и сделаю) рекомендует пользоваться информацией по этой ссылке, т.к. уверен на данный момент, что там всё правильно и годится для эксплуатации нашей ЦСП. Т.е. эта ссылка дополняет РЭ, а я не берусь судить о ней или что-то там редактировать и тем более отвечать за правильность по смыслу этого текста - у меня нет для этого достаточных знаний: я по сути дела добавляю в РЭ только то, что скажут/напишут мне истинные разработчики харда и софта, в данном случае это ты и САН, за которым последнее слово и решение "быть или не быть" чему-то в РЭ, а он в комменте-45 сказал:
"...для РЭ достаточно разместить только ссылку
" ​wiki/Ethernet для описания полной конфигурации Ethernet",
и при этом он не считает меня автором текста по этой ссылке,
и не считает, что если я размещаю ссылку, то я же и должен редактировать текст по этой ссылке."

Вот его слова в Комм-35:
"Я предложил добавить в РЭ пока ссылку, т.к. я не готов сейчас изучить весь объём материала и оценить что нужно добавить в РЭ и куда, а чего не хватает и что об этом сказать пользователю.
Бездумно вставлять весь кусок текста куда-попало я не хочу, ссылка лучше чем ничего."
Так я и сделал: вставил в РЭ ссылку на статью от САН.
Вот Комм-53 Начальника САН:
"Я воспринимаю эту ссылку, как ссылку на дополнительную информацию,
которая может заинтересовать пользователя. а не как часть РЭ."

Кстати, в Комм-57 я записал
"А может ли не Автор этой статьи редактировать её?
А если может, то как защитить статью от изменения, если не автор может напечатать там ложь? :-)"
Т.е. я имел ввиду не себя, а Автора статьи, т.е. САН, о ты почему-то закрыл доступ всем, кроме меня :)

Спор уже затянулся на 108 Комментов, поэтому "быть или не быть" полному описанию Ethernet в РЭ
и когда именно (сейчас, или "когда-нибудь") должен решить САН и переоткрыть этот тикет
и тогда я добавлю в Приложение РЭ полную копию статьи по ссылке, а изменения буду вносить по будущим тикетам об изменении текста (только бы текст изменений лучше сразу изложить в стиле РЭ, указав конкретное место и конкретный текст вставки)

Одни документ не является частью РЭ, потому что в редакции 56 другого документа было записано точно так же, как и в его же редакции 58? Серьезно? Прости, но я в таком объяснении не вижу никакой логики...

Я уже запутался в твоей и своей логике: пиши конкретно, какие слова надо заменить на другие,
и если САН одобрит, то я вставлю в РЭ, как есть, слово в слово :)

И еще одно соображение. Ты говоришь, что статья, в которой описано, как настраивать целый ряд функций ethernet платы SW-01 и их настройка, частью РЭ не являлась. Но если так, то получается, что в РЭ эти функции не описаны (а решение о том, что их описывать не надо, на тот момент принято еще не было!)! Следовательно, РЭ, разработчиком которого ты являешься и за которое отвечаешь, было неполным...

Я не могу отвечать за то, чего не знаю, для меня это мало знакомая тема:
напиши конкретный текст по своему разумению и я вставлю.

Я по-прежнему считаю, что это хорошо и правильно, когда текст редактирует тот и только тот, кто за него отвечает.

Даже если этот "кто" ничего не знает по этой теме? :-)
Я не могу отвечать за то, чего не знаю, для меня это мало знакомая тема:
напиши конкретный текст по своему разумению и я вставлю.
Всё-таки текст лучше сочинять разработчику харда и софта, а не разработчику РЭ,
который не может знать всё обо всех изделиях и софте в нашей ЦСП.

Жду решение: уже пора копировать 1:1 текст по ссылке в РЭ-59,
или ждём окончательной отработки этого текста в Вики ?

in reply to:  108 ; comment:109 by alx, 7 months ago

Replying to Vladimir:

А разве в РЭ категорически запрещено давать ссылки на дополнительные источники информации,
которые более подробно описывают возможные действия?

Это тебе лучше знать. Я не разработчик РЭ, я ничего об этом не знаю. Это вне моей компетенции.

Я уже запутался в твоей и своей логике: пиши конкретно, какие слова надо заменить на другие,

Я понятия не имею, какие слова тебе надо заменить на какие. Я задал тебе вопрос, а хоть сколько-нибудь понятного ответа по существу на него не получил...

Я не могу отвечать за то, чего не знаю, для меня это мало знакомая тема:
напиши конкретный текст по своему разумению и я вставлю.

Так я же ровно это и делал (перечитай тикет-то!), пока ты не принял решение сначала не вставлять описание в PDF, а послать читателя по ссылке, а потом - что и этого не надо...

Я по-прежнему считаю, что это хорошо и правильно, когда текст редактирует тот и только тот, кто за него отвечает.

Даже если этот "кто" ничего не знает по этой теме? :-)

Не понял вопрос... Что "Даже если этот "кто" ничего не знает по этой теме"? Что мешает этому "кте" узнать все, что ему требуется для качественного выполнения своей работы?

Я не могу отвечать за то, чего не знаю, для меня это мало знакомая тема:
напиши конкретный текст по своему разумению и я вставлю.

??? Ты же сам два дня назад закрыл тикет с резолюцией "не будем делать". Так заем же я буду зря тратить свое время?

Всё-таки текст лучше сочинять разработчику харда и софта, а не разработчику РЭ,
который не может знать всё обо всех изделиях и софте в нашей ЦСП.

Почему же он не может знать? У него есть мозг, значит знать он может... :)

Жду решение:
уже пора копировать 1:1 текст по ссылке в РЭ-59,
или ждём окончательной отработки этого текста в Вики ?

Ты ждешь его от меня? Если да, то напрасно - решения по РЭ выходят за рамки моих полномочий и компетенции. Я не разработчик РЭ. Я - разработчик аппаратуры, и решения я принимаю по аппаратуре.

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

in reply to:  109 ; comment:110 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

А разве в РЭ категорически запрещено давать ссылки на дополнительные источники информации,
которые более подробно описывают возможные действия?

Это тебе лучше знать. Я не разработчик РЭ, я ничего об этом не знаю. Это вне моей компетенции.

Ну вот я и решил, а САН разрешил пока оставить в РЭ ссылку на статью

Я не могу отвечать за то, чего не знаю, для меня это мало знакомая тема:
напиши конкретный текст по своему разумению и я вставлю.

Так я же ровно это и делал (перечитай тикет-то!),

В Тикете написано:
"Мы (разработчики блока 3U) не принимали решения, что полный вариант интерфейса не надо описывать вообще никогда, мы просто договорились, что описание функций, которые доступны только в нем (в виду не очень частого использования), отложим в "долгий ящик" на неопределенное "потом"" - этот текст для вставки в РЭ не годится :)

пока ты не принял решение сначала не вставлять описание в PDF, а послать читателя по ссылке, а потом - что и этого не надо...

То, что совсем "не надо" я не утверждал: ссылка уже давно присутствует в РЭ,
а вот вставлять текст по этой ссылке в РЭ, на мой взгляд пока не надо,
т.к. ещё будут возможны изменения в Вики. Вот когда автор текста по ссылке твёрдо скажет,
что уже всё, что требуется уже годится для вставки в РЭ и надо вставить, то я это сделаю,
а до этого времени пусть будет ссылка - это лучше, чем ничего :-)
Но я бы навсегда оставил эту и другие ссылки на более подробную информацию о настройках:
у всех же есть возможность кликнуть по ссылке и через 1...3 секунды увидеть/прочитать/скопировать/распечатать полное описание конфигурации Ethernet - зачем тогда это описание порядка 50 страниц вставлять в РЭ?
Но если САН скажет, что текст уже хорошо отработан и его пора вставить в РЭ, то я вставлю, даже если против этого.

Я по-прежнему считаю, что это хорошо и правильно, когда текст редактирует тот и только тот, кто за него отвечает.

Даже если этот "кто" ничего не знает по этой теме? :-)

Не понял вопрос... Что "Даже если этот "кто" ничего не знает по этой теме"? Что мешает этому "кто" узнать все, что ему требуется для качественного выполнения своей работы?

Автор текста по ссылке - САН, а ты, возможно, его соавтор - вот Вам, Знатокам, и отвечать за достоверность.
А я даже точный вопрос на эту тему сформулировать не могу, не знаю, "что мне требуется для качественного выполнения своей работы", поэтому жду решение от Автора текста.

??? Ты же сам два дня назад закрыл тикет с резолюцией "не будем делать". Так заем же я буду зря тратить свое время?

Улучшить РЭ никогда не поздно, даже если тикет уже закрыт: если появится конкретное предложение, то я вставлю.
Вспомни, сколько было "реоупэндов" после закрытия разных тикетов.

Всё-таки текст лучше сочинять разработчику харда и софта, а не разработчику РЭ,
который не может знать всё обо всех изделиях и софте в нашей ЦСП.

Почему же он не может знать? У него есть мозг, значит знать он может... :)

Для этого мне потребуется, возможно, несколько лет, чтобы достигнуть в этом вопросе
такого же уровня знаний и опыта, как у тебя и у САН

Жду решение:
уже пора копировать 1:1 текст по ссылке в РЭ-59,
или ждём окончательной отработки этого текста в Вики ?

Ты ждешь его от меня?

Жду от САН, а ты мог бы высказать свою точку зрения о качестве текста от САН -
всё ли там хорошо, надо ли что-то добавить/убавить, уточнить по твоему мнению, как Знатока?

Last edited 7 months ago by Vladimir (previous) (diff)

comment:111 by san, 7 months ago

Простите, но мне тупо лень читать 100+ комментов этого тикета, отвечу на то что вижу:

Текст статьи https://trac.adc-line.ru/sw-01/wiki/Ethernet написан alx, я лишь когда-то давно создал эту статью.
По поводу содержимого, я не готов ответить пригодно ли это для вставки в РЭ и куда и что можно вставить, т.к. сам ещё не прочитал.

in reply to:  111 comment:112 by Vladimir, 7 months ago

Replying to san:

Простите, но мне тупо лень читать 100+ комментов этого тикета, отвечу на то что вижу:

Текст статьи https://trac.adc-line.ru/sw-01/wiki/Ethernet написан alx, я лишь когда-то давно создал эту статью.
По поводу содержимого, я не готов ответить пригодно ли это для вставки в РЭ и куда и что можно вставить, т.к. сам ещё не прочитал.

А вот и ответ на вопрос "быть или не быть" ссылке в РЭ и пора ли копировать текст из ссылки в РЭ.
Общедоступная всем ссылка уже давно в РЭ и пусть пока там остаётся.
Как только текст по ссылке созреет для вставки в РЭ, так я и вставлю, даже если не согласен с этим :)

Last edited 7 months ago by Vladimir (previous) (diff)

in reply to:  110 ; comment:113 by alx, 7 months ago

Replying to Vladimir:

пока ты не принял решение сначала не вставлять описание в PDF, а послать читателя по ссылке, а потом - что и этого не надо...

То, что совсем "не надо" я не утверждал:

Ты закрыл тикет, предлагающий добавить в РЭ описание функций ethernet, с резолюцией "Не будем делать". По-моему это с полной очевидностью говорит о том, что тобой принято решение отклонить предложение тикета. А из этого факта, в свою очередь, я сделал вывод, что ты считаешь, что описывать настройки ethernet не надо (если бы считал, что надо, не отклонил бы предложение их описать!).

ссылка уже давно присутствует в РЭ,
а вот вставлять текст по этой ссылке в РЭ, на мой взгляд пока не надо,
т.к. ещё будут возможны изменения в Вики. Вот когда автор текста по ссылке твёрдо скажет,
что уже всё, что требуется уже годится для вставки в РЭ и надо вставить, то я это сделаю,

??? Как странно... Ведь ровно так все и было целый год - с 1 декабря 2021 г., когда я по твоей просьбе переоткрыл тикет, до 2 декабря 2022 г.,когда ты тикет закрыл (первый раз из трех)! За это время я успел описать процентов 80 настроек... Если ты не принимал решения отклонить предложение тикета и по-прежнему намерен его реализовать, зачем же тогда ты уже трижды закрыл тикет?

Автор текста по ссылке - САН, а ты, возможно, его соавтор - вот Вам, Знатокам, и отвечать за достоверность.

Я отвечаю за достоверность написанного мной текста, но не за текст РЭ.

А я даже точный вопрос на эту тему сформулировать не могу, не знаю, "что мне требуется для качественного выполнения своей работы", поэтому жду решение от Автора текста.

Я не могу принять за тебя решение о том, какой информации тебе не хатает для качественного выполнения тобой твоей работы.

Улучшить РЭ никогда не поздно, даже если тикет уже закрыт: если появится конкретное предложение, то я вставлю.

Вот когда и если у меня появится какое-нибудь предложение о том, как улучшить РЭ, тогда я его для тебя напишу.

Жду решение:

Ты ждешь его от меня?

Жду от САН, а ты мог бы высказать свою точку зрения о качестве текста от САН -
всё ли там хорошо, надо ли что-то добавить/убавить, уточнить по твоему мнению, как Знатока.

Я не могу высказать свою точку зрения, так как не видел текста от san, и даже не знаю, о каком вообще тексте ты говоришь.

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

in reply to:  110 comment:114 by alx, 7 months ago

Replying to Vladimir:

Но я бы навсегда оставил эту и другие ссылки на более подробную информацию о настройках:
у всех же есть возможность кликнуть по ссылке и через 1...3 секунды увидеть/прочитать/скопировать/распечатать полное описание конфигурации Ethernet - зачем тогда это описание порядка 50 страниц вставлять в РЭ?

Ты уже задавал мне этот вопрос, и я тебе на него отвечал. Мое мнение с тех пор не изменилось.

Вспомни, сколько было "реоупэндов" после закрытия разных тикетов.

Зачем мне это делать? :)

in reply to:  113 ; comment:115 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:
Ты закрыл тикет, предлагающий добавить в РЭ описание функций ethernet, с резолюцией "Не будем делать". По-моему это с полной очевидностью говорит о том, что тобой принято решение отклонить предложение тикета. А из этого факта, в свою очередь, я сделал вывод, что ты считаешь, что описывать настройки ethernet не надо (если бы считал, что надо, не отклонил бы предложение их описать!).

Описывать настройки надо, для этого достаточно при чтении РЭ кликнуть на ссылку
и увидеть/прочитать полный текст этой настройки.
Для меня это эквивалентно тому, что описание полной конфигурации Езернет в РЭ есть.

Если ты не принимал решения отклонить предложение тикета и по-прежнему намерен его реализовать, зачем же тогда ты уже трижды закрыл тикет?

Т.к. считал, что вполне достаточно прочитать настройку по указанной в РЭ ссылке:
зачем дублировать 50 страниц в РЭ и в Вики, а потом при необходимости исправлять его в двух местах?

Автор текста по ссылке - САН, а ты, возможно, его соавтор - вот Вам, Знатокам, и отвечать за достоверность.

Я отвечаю за достоверность написанного мной текста, но не за текст РЭ.

Автор текста, как оказалось, ты и ты отвечаешь за его достоверность -
вот по ссылке на твой достоверный текст каждый юзер и будет видеть актуальную информацию!
И это хорошо на мой взгляд. А за копию твоего текста в РЭ, получается, что я должен отвечать...

Жду от САН, а ты мог бы высказать свою точку зрения о качестве текста от САН -
всё ли там хорошо, надо ли что-то добавить/убавить, уточнить по твоему мнению, как Знатока.

Я не могу высказать свою точку зрения, так как не видел текста от san, и даже не знаю, о каком вообще тексте ты говоришь.

Так САН уже ответил, что "Текст статьи ​https://trac.adc-line.ru/sw-01/wiki/Ethernet написан alx, я лишь когда-то давно создал эту статью."
По этой ссылке ты можешь в одно касание увидеть свой текст!

in reply to:  115 ; comment:116 by alx, 7 months ago

Replying to Vladimir:

Для меня это эквивалентно тому, что описание полной конфигурации Езернет в РЭ есть.

То есть ты отклонил предложение добавить в РЭ описание настроек ethernet, потому что считаешь, что они там и так уже есть. Я правильно тебя понял?

Жду от САН, а ты мог бы высказать свою точку зрения о качестве текста от САН -
всё ли там хорошо, надо ли что-то добавить/убавить, уточнить по твоему мнению, как Знатока.

Я не могу высказать свою точку зрения, так как не видел текста от san, и даже не знаю, о каком вообще тексте ты говоришь.

Так САН уже ответил, что "Текст статьи ​https://trac.adc-line.ru/sw-01/wiki/Ethernet написан alx,

Я об этом и не спрашивал, я знаю, кто написал тот текст. А если бы даже и не знал, все равно бы не спрашивал, а посмотрел бы сам, кто делал правки...

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

in reply to:  116 ; comment:117 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

Для меня это эквивалентно тому, что описание полной конфигурации Езернет в РЭ есть.

То есть ты отклонил предложение добавить в РЭ описание настроек ethernet, потому что считаешь, что они там и так уже есть. Я правильно тебя понял?

По сути дела есть - достаточно только 1 раз кликнуть - разве это трудно?
Даже если я скопирую 50 страниц по ссылке и вставлю, например, в Приложение-15,
то всё-равно надо будет кликнуть по ссылке на Приложение-15.
Сейчас ссылка https://trac.adc-line.ru/sw-01/wiki/Ethernet находится в пункте:
"6.2.3 Вкладка Ethernet - настройка коммутатора платы SW-01", который занимает всего одну страницу,
а если вставить тут полный текст по ссылке - то тут добавится 50 страниц текста, который требуется, возможно, всего для 0,1% юзеров, поэтому, имхо, лучше уж этот текст вставить в Приложение-15.

Я не могу высказать свою точку зрения, так как не видел текста от san, и даже не знаю, о каком вообще тексте ты говоришь.

Так САН уже ответил, что "Текст статьи ​https://trac.adc-line.ru/sw-01/wiki/Ethernet написан alx,

Я об этом и не спрашивал

Да, но ответил: "не видел текста от san, и даже не знаю, о каком вообще тексте ты говоришь."

  • вот я и напомнил, что ты видел и знаешь :-)
Last edited 7 months ago by Vladimir (previous) (diff)

in reply to:  117 ; comment:118 by alx, 7 months ago

Replying to Vladimir:

По сути дела есть - достаточно только 1 раз кликнуть - разве это трудно?

Мне этот вариант не нравится не потому, что я считаю, что кликать ссылки трудно (хотя, сколько бы легко это ни было, кликать труднее чем не кликать), а потому, что я считаю, что это нарушение принятой ранее системы, стиля, можно сказать. Сразу возникает вопрос: почему одни настройки описаны в одном документе, а другие вынесены в другой? Почему они удостоились такой особой "чести", и почему другие настройки ей не удостоены? Если бы, например, каждая вкладка веб-интерфейса была описана в отдельном документе, то я бы, наверное, не возражал. Но когда одно описано здесь, другое - там, третье - еще непонятно где, это выглядит некрасиво, так как отсутствует единая понятная читателю система.

В интернете много раз видел, как пользователю предлагается выбор: читать какое-то описание одним большим документом, который включает сразу все (все на одной странице) или разбитым по разделам - каждый раздел в отдельном документе (отдельной страницей). Но, заметь, что во втором варианте это каждый раздел, какого бы размера он ни был, хоть всего одна строчка. Потому что есть система, которой автор придерживался!

Даже если я скопирую 50 страниц по ссылке и вставлю, например, в Приложение-15,

??? Зачем же добавлять в Приложение-15? 8-O Настройки ethernet, насколько я вижу, описываются в разделе 6.2, а не в Приложении-15! Вот это как раз пример того, о чем я написал выше - отсутствия единой и понятной системы: часть настроек описаны в одном месте документа, часть - совсем в другом...

то всё-равно надо будет кликнуть по ссылке на Приложение-15.

Не обязательно. Нужную информацию можно найти и поиском... А так ведь это же самое (что необходимо кликнуть ссылку) можно сказать вообще о любом месте в РЭ - например чтобы увидеть текст раздела "2.2 Устройство и работа блока MC04−DSL−3U" надо кликнуть ссылку в Оглавлении...

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

а если вставить тут полный текст по ссылке - то тут будет 51 страница текста, который требуется, возможно, всего для 0,1% юзеров, поэтому, имхо, лучше уж этот текст вставить в Приложение-15.

??? Эту логику я не понял... Ты хочешь сказать, что если вставить описание настроек ethernet в Приложение-15, то размер РЭ будет меньше, чем если вставить то же описание в какое-то другое место?

Я об этом и не спрашивал

Да, но ответил: "не видел текста от san, и даже не знаю, о каком вообще тексте ты говоришь."

Да, я ответил именно так. :)

  • вот я и напомнил, что ты видел и знаешь :-)

Спасибо за напоминание. Однако твое напоминание не соответствует действительности - я текста от san не видел, поэтому свою точку зрения о его качестве по-прежнему высказать не могу.

in reply to:  118 ; comment:119 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

По сути дела есть - достаточно только 1 раз кликнуть - разве это трудно?

Сразу возникает вопрос: почему одни настройки описаны в одном документе, а другие вынесены в другой?

Есть такое правило: "Что не запрещено, то разрешено!", т.е. можно действовать более гибко :)
Запрета на ссылки к другим документам нет и таких ссылок уже множество в этом и других документах,
поэтому разработчик/редактор РЭ может действовать по своему усмотрению :-)
На "Почему" - всё просто: разработчик решил, что большие объёмы информации (десятки страниц),
которые требуется ничтожному числу юзеров, лучше не вставлять в регулярный текст описания:
пока юзер будет читать десятки страниц отступления от основного текста, он уже частично забудет
и потеряет нить регулярного описания. По ссылке открывается большое "Содержание" (оглавление),
состоящее из 33-х пунктов - это совсем затруднит поиск в основном Оглавлении
и поменяет нумерацию существующих уже привычных пунктов и ссылок на них...
а в Приложении я бы разместил отдельное оглавление для этой темы.
К тому же, в РЭ уже 6 лет от появления этого тикета и 11 лет от первых поставок ЦСП-3U не было полного описания конфигурации Езернет и до сих пор нет, хотя в эксплуатации уже тысячи наших ЦСП-3U,
т.е. это не настолько уж важная и срочная информация для большинства юзеров - так зачем же её вставлять в каждый экземпляр РЭ, если это мало кому надо, а если вдруг потребуется, то можно кликнуть и получить.

то всё-равно надо будет кликнуть по ссылке на Приложение-15.

Не обязательно. Нужную информацию можно найти и поиском... А так ведь это же самое (что необходимо кликнуть ссылку) можно сказать вообще о любом месте в РЭ - например чтобы увидеть текст раздела "2.2 Устройство и работа блока MC04−DSL−3U" надо кликнуть ссылку в Оглавлении...

В оглавлении приложений будет и ссылка про полную конфигурацию Езернет,
как уже есть подобные приложения, например:
13.4 Приложение 4. Структура потока E1.
13.5 Приложение 5. Описание технологии VLAN.
13.6 Приложение 6. Конфигурация сервера Zabbix
и другие. Да и в тексте основного описания есть гипер-ссылки на эти Приложения.

Большие пункты на десятки страниц "засоряют" основной текст изложения, уводят "в сторону"

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

Чёрно-белые рисунки я умышленно не делал - мне их прислали Разработчики харда и софта,
а я просто не смог воспроизвести в цвете на своём ПК подобные изображения...
Яркость и контрастность я менял умышленно, т.к. распечатки цветных рисунков на ч/б принтере
были трудно-читаемые из-за низкой контрастности. Цвет я не корректировал:
при изменении яркости и контрастности менялся и оттенок цвета.

а если вставить тут полный текст по ссылке - то тут будет 51 страница текста, который требуется, возможно, всего для 0,1% юзеров, поэтому, имхо, лучше уж этот текст вставить в Приложение-15.

??? Эту логику я не понял... Ты хочешь сказать, что если вставить описание настроек ethernet в Приложение-15, то размер РЭ будет меньше, чем если вставить то же описание в какое-то другое место?

Нет, большая вставка на десятки страниц уводит читателя от основного изложения, причём эти огромные тексты будут мешать большинству читателей, а редко кому очень надо - посмотрит это в Приложении или по ссылке.

Спасибо за напоминание. Однако твое напоминание не соответствует действительности - я текста от san не видел, поэтому свою точку зрения о его качестве по-прежнему высказать не могу.

Ты мог и можешь его увидеть в 1 клик по ссылке! :-)

in reply to:  119 ; comment:120 by alx, 7 months ago

Replying to Vladimir:

Есть такое правило: "Что не запрещено, то разрешено!", т.е. можно действовать более гибко :)
Запрета на ссылки к другим документам нет и таких ссылок уже множество в этом и других документах,
поэтому разработчик/редактор РЭ может действовать по своему усмотрению :-)

Ты ломишься в открытую дверь. Я никогда и не говорил, что ссылки на другие документы запрещены. Ты меня, наверное, с кем-то путаешь... :)

Тут я поскипал много текста, так как, если честно, не понял, для чего это было написано. Сказанному мной оно не противоречит, вопросов я там тоже не увидел. Если ты хотел подвести меня к какому-то выводу, то я не понял, к какому...

Верно ли я понял, что ты больше так не считаешь?

Чёрно-белые рисунки я умышленно не делал...
Яркость и контрастность я менял ...
Цвет я не корректировал...

...И на мой вопрос не ответил. :(

Спасибо за напоминание. Однако твое напоминание не соответствует действительности - я текста от san не видел, поэтому свою точку зрения о его качестве по-прежнему высказать не могу.

Ты мог и можешь его увидеть в 1 клик по ссылке! :-)

Нет, не мог и не могу, так как у меня нет ссылки. :)

in reply to:  120 ; comment:121 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

Запрета на ссылки к другим документам нет и таких ссылок уже множество в этом и других документах,
поэтому разработчик/редактор РЭ может действовать по своему усмотрению :-)

Ты ломишься в открытую дверь. Я никогда и не говорил, что ссылки на другие документы запрещены. Ты меня, наверное, с кем-то путаешь... :)

А почему тогда ты против ссылки: " https://trac.adc-line.ru/sw-01/wiki/Ethernet "
и настаиваешь, что вместо ссылки тут надо вставить 50 страниц со своим Оглавлением из 33 пунктов
Это же ссылка на другой документ, причём на нашем "trac.adc-line.ru"

Тут я поскипал много текста, так как, если честно, не понял, для чего это было написано. Сказанному мной оно не противоречит, вопросов я там тоже не увидел. Если ты хотел подвести меня к какому-то выводу, то я не понял, к какому...

А что ты поскипал?
Ответ на вопрос "почему одни настройки описаны в одном документе, а другие вынесены в другой?"
Это про вставку десятков страниц в пункт "6.2.3 Вкладка Ethernet - настройка коммутатора платы SW-01",
т.е. отложить на 50 страниц с оглавлением из 33 позиций описание подвкладок на
"Рис. 6.8 Вкладка Ethernet отображает состояние портов коммутатора платы SW-01"
и через эти 50 страниц продолжить описание в пунктах:
6.2.4 Вкладка Ethernet / Порты
6.2.5 Вкладка Ethernet / VLAN
6.2.6 Вкладка Ethernet / Multicast (групповая передача)
6.2.7 Вкладка Ethernet / RSTP (настройка работы портов Ethernet-коммутатора)
6.2.8 Вкладка Ethernet / Trunks (настройка агрегации каналов Ethernet)

Это слишком большой разрыв в описании между
6.2.3 Вкладка Ethernet - настройка коммутатора платы SW-01
и 6.2.4 Вкладка Ethernet / Порты и далее 6.2.5...8

На мой взгляд лучше уж описать подряд пункты 6.2.3...8,
а в п.6.2.3 дать ссылку на Трак или на Приложение-15 с подробнейшим описанием
полной конфигурации - если кого-то это заинтересует, то он посмотрит.

Верно ли я понял, что ты больше так не считаешь?

А мне казалось что я косвенно ответил, что ты неверно понял
и я подробно ответил в 5 строчках:
"> > Чёрно-белые рисунки я умышленно не делал...

Яркость и контрастность я менял ...
Цвет я не корректировал..."

...И на мой вопрос не ответил. :(

Ответил текстом в 5 строчках:
"Чёрно-белые рисунки я умышленно не делал - мне их прислали Разработчики харда и софта,
а я просто не смог воспроизвести в цвете на своём ПК подобные изображения...
Яркость и контрастность я менял умышленно, т.к. распечатки цветных рисунков на ч/б принтере
были трудно-читаемые из-за низкой контрастности. Цвет я не корректировал:
при изменении яркости и контрастности менялся и оттенок цвета.
".

Ты мог и можешь его увидеть в 1 клик по ссылке! :-)

Нет, не мог и не могу, так как у меня нет ссылки. :)

Странно, а в комментах к ЭТОМУ тикету я нашёл 29 таких ссылок!
Комменты:
17,19,22,29,31,53,61,72,80,81,82,87,90,94,95,97,100,102,103,104,105,106,107,108,111,112,115,116,117.
Как ты мог их не заметить?! :-)

Last edited 7 months ago by Vladimir (previous) (diff)

in reply to:  121 ; comment:122 by alx, 7 months ago

Replying to Vladimir:

А почему тогда ты против ссылки: " https://trac.adc-line.ru/sw-01/wiki/Ethernet "

Я это уже несколько раз здесь объяснял. Перечитай комментарии.

и настаиваешь, что вместо ссылки тут надо вставить 50 страниц со своим Оглавлением из 33 пунктов

Ты меня опять с кем-то путаешь. :) Я на этом не настаиваю. Ты спросил мое мнение, я его написал и аргументировал. У тебя мнение может быть другим. Разработчик РЭ - ты, а не я, поэтому решение принимаешь ты, а не я. У меня нет ни полномочий, ни морального права настаивать...

Это же ссылка на другой документ, причём на нашем "trac.adc-line.ru"

И что?

Тут я поскипал много текста, так как, если честно, не понял, для чего это было написано. Сказанному мной оно не противоречит, вопросов я там тоже не увидел. Если ты хотел подвести меня к какому-то выводу, то я не понял, к какому...

А что ты поскипал?

Я поскипал вот это:


На "Почему" - всё просто: разработчик решил, что большие объёмы информации (десятки страниц),
которые требуется ничтожному числу юзеров, лучше не вставлять в регулярный текст описания:
пока юзер будет читать десятки страниц отступления от основного текста, он уже частично забудет
и потеряет нить регулярного описания. По ссылке открывается большое "Содержание" (оглавление),
состоящее из 33-х пунктов - это совсем затруднит поиск в основном Оглавлении
и поменяет нумерацию существующих уже привычных пунктов и ссылок на них...
а в Приложении я бы разместил отдельное оглавление для этой темы.
К тому же, в РЭ уже 6 лет от появления этого тикета и 11 лет от первых поставок ЦСП-3U не было полного описания конфигурации Езернет и до сих пор нет, хотя в эксплуатации уже тысячи наших ЦСП-3U,
т.е. это не настолько уж важная и срочная информация для большинства юзеров - так зачем же её вставлять в каждый экземпляр РЭ, если это мало кому надо, а если вдруг потребуется, то можно кликнуть и получить.

то всё-равно надо будет кликнуть по ссылке на Приложение-15.

Не обязательно. Нужную информацию можно найти и поиском... А так ведь это же самое (что необходимо кликнуть ссылку) можно сказать вообще о любом месте в РЭ - например чтобы увидеть текст раздела "2.2 Устройство и работа блока MC04−DSL−3U" надо кликнуть ссылку в Оглавлении...

В оглавлении приложений будет и ссылка про полную конфигурацию Езернет,
как уже есть подобные приложения, например:
13.4 Приложение 4. Структура потока E1.
13.5 Приложение 5. Описание технологии VLAN.
13.6 Приложение 6. Конфигурация сервера Zabbix
и другие. Да и в тексте основного описания есть гипер-ссылки на эти Приложения.

Большие пункты на десятки страниц "засоряют" основной текст изложения, уводят "в сторону"


А ты сам разве не мог прочитать текст своего же комментария, на который я отвечал? У тебя не все комментарии отображаются?

Ответ на вопрос "почему одни настройки описаны в одном документе, а другие вынесены в другой?"

??? Что "Ответ на вопрос "почему одни настройки описаны в одном документе, а другие вынесены в другой?""? У тебя предложение обрывается на середине...

...И на мой вопрос не ответил. :(

Ответил текстом в 5 строчках:
"Чёрно-белые рисунки я умышленно не делал - мне их прислали Разработчики харда и софта,
а я просто не смог воспроизвести в цвете на своём ПК подобные изображения...
Яркость и контрастность я менял умышленно, т.к. распечатки цветных рисунков на ч/б принтере
были трудно-читаемые из-за низкой контрастности. Цвет я не корректировал:
при изменении яркости и контрастности менялся и оттенок цвета.
".

В процитированных пяти строчках ответа на мой вопрос не вижу. По-моему его там нет.

Нет, не мог и не могу, так как у меня нет ссылки. :)

Странно, а в комментах к ЭТОМУ тикету я нашёл 29 таких ссылок!
Комменты:
17,19,22,29,31,53,61,72,80,81,82,87,90,94,95,97,100,102,103,104,105,106,107,108,111,112,115,116,117.
Как ты мог их не заметить?! :-)

Спасибо за уточнение. Эти ссылки я, конечно же, замечал, но как раз в comment:110, где ты попросил высказать мою точку зрения о тексте san, этой ссылки нет. Поэтому я не знал, высказать мнение о каком именно тексте ты просишь.

Вот мое мнение, изволь. На мой взгляд, качество текста san высокое. Действительно, вместо "шлобально" правильнее писать "глобально", вместо "присваевается" лучше писать "присваивается", вместо "Криоритет" - "Приоритет", вместо "медлу" - "между", вместо "конфигуарцией" - "конфигурацией", вместо "очреедной" - "очередной", вместо "обрабатываемях" - "обрабатываемых", вместо "блыо" - "было", а слова "соответствующий" и "данному" действительно следует разделять пробелом. Наверное нет смысла перечислять здесь все сделанные san исправления. Скажу только, что я просмотрел их все и не встретил ни одного, с которым я был бы не согласен (правда, я не такой уж большой знаток правописания). Пользуясь случаем, благодарю san за все сделанные им исправления.

in reply to:  122 ; comment:123 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:

А почему тогда ты против ссылки: " https://trac.adc-line.ru/sw-01/wiki/Ethernet "
и настаиваешь, что вместо ссылки тут надо вставить 50 страниц со своим Оглавлением из 33 пунктов

Я на этом не настаиваю. Ты спросил мое мнение, я его написал и аргументировал. У тебя мнение может быть другим. Разработчик РЭ - ты, а не я, поэтому решение принимаешь ты, а не я. У меня нет ни полномочий, ни морального права настаивать...

Хорошо, ты не настаиваешь, но рекомендуешь, а я стараюсь учитывать рекомендации Знатоков :-)

Большие пункты на десятки страниц "засоряют" основной текст изложения, уводят "в сторону"


А ты сам разве не мог прочитать текст своего же комментария, на который я отвечал? У тебя не все комментарии отображаются?

Комментов уже так много, что трудно найти нужный :-)

Ответ на вопрос "почему одни настройки описаны в одном документе, а другие вынесены в другой?"

??? Что "Ответ на вопрос "почему одни настройки описаны в одном документе, а другие вынесены в другой?""?

Подробный ответ на этот вопрос был в 14 строчках коммента-119

У тебя предложение обрывается на середине...
Не увидел эту "середину" среди 14 строк ответа.

...И на мой вопрос не ответил. :(

Ответил текстом в 5 строчках:
"Чёрно-белые рисунки я умышленно не делал - мне их прислали Разработчики харда и софта,
а я просто не смог воспроизвести в цвете на своём ПК подобные изображения...
Яркость и контрастность я менял умышленно, т.к. распечатки цветных рисунков на ч/б принтере
были трудно-читаемые из-за низкой контрастности. Цвет я не корректировал:
при изменении яркости и контрастности менялся и оттенок цвета.
".

В процитированных пяти строчках ответа на мой вопрос не вижу. По-моему его там нет.

Ответ был фразой:
"alex: Верно ли я понял, что ты больше так не считаешь?
VU: А мне казалось что я косвенно ответил, что ты неверно понял":
ты: "... Верно ли я понял", я: "ты неверно понял"
и дальше было пояснение, что ч/б рисунков окон я не делал, а цветные вместо ч/б не смог сделать,
но если ты пришлёшь цветные скрины, то я заменю ч/б рисунки на цветные.

Вот мое мнение, изволь. На мой взгляд, качество текста san высокое.

Тогда ждём, когда САН твёрдо скажет, что уже пока вставить текст по ссылке в РЭ,
т.к. до этого были его предложения сделать это в будущем - а настало ли уже это время? :-)

Вот цитаты от САН по поводу вставки в РЭ текста по ссылке:
"Я думаю, что дублированная информации в вики никому не помешает, а часто она даже более надёжна и информативна чем РЭ, поэтому пусть вики живёт своей жизнью а РЭ своей.
Я предложил добавить в РЭ пока ссылку, т.к. я не готов сейчас изучить весь объём материала и оценить что нужно добавить в РЭ и куда, а чего не хватает и что об этом сказать пользователю.
Бездумно вставлять весь кусок текста куда-попало я не хочу, ссылка лучше чем ничего."

"В.У.: А текст по этой ссылке уже достаточно отработан, чтобы его вставить в РЭ?
Не могу сказать, там довольно большой объём информации, я сам ещё до конца не разобрался как всё работает."

"comment:111 by san, 25 часов ago
Текст статьи ​https://trac.adc-line.ru/sw-01/wiki/Ethernet написан alx, я лишь когда-то давно создал эту статью.
По поводу содержимого, я не готов ответить пригодно ли это для вставки в РЭ и куда и что можно вставить, т.к. сам ещё не прочитал."

Таким образом, я жду окончательное решение от САН - как только он скажет, что текст по ссылке уже пригоден
"для вставки в РЭ ... и куда и что можно вставить", так я и вставлю,
а пока уже давно в РЭ есть ссылка на Вики.

Last edited 7 months ago by Vladimir (previous) (diff)

in reply to:  123 ; comment:124 by alx, 7 months ago

Replying to Vladimir:

Комментов уже так много, что трудно найти нужный :-)

Кликаешь "Vladimir" в строке "Replying to Vladimir:" и видишь комментарий, на который я отвечал. По-моему ничего трудного...

Ответ на вопрос "почему одни настройки описаны в одном документе, а другие вынесены в другой?"

У тебя предложение обрывается на середине...
Не увидел эту "середину" среди 14 строк ответа.

Ты написал:

Ответ на вопрос "..."

и дальше ничего нет - нет конца предложения, нет даже сказуемого (что делает ответ на этот вопрос?). Предложение обрывается после цитаты. "Серединой" я назвал то самое место, где предложение оборвалось - после закрывающей кавычки.

Ответил текстом в 5 строчках:
"Чёрно-белые рисунки я умышленно не делал - мне их прислали Разработчики харда и софта,
а я просто не смог воспроизвести в цвете на своём ПК подобные изображения...
Яркость и контрастность я менял умышленно, т.к. распечатки цветных рисунков на ч/б принтере
были трудно-читаемые из-за низкой контрастности. Цвет я не корректировал:
при изменении яркости и контрастности менялся и оттенок цвета.
".

В процитированных пяти строчках ответа на мой вопрос не вижу. По-моему его там нет.

Ответ был фразой:
"alex: Верно ли я понял, что ты больше так не считаешь?
VU: А мне казалось что я косвенно ответил, что ты неверно понял":
ты: "... Верно ли я понял", я: "ты неверно понял"

В процитированных тобой пяти строчках этой фразы нет. Следовательно, и ответа в них тоже нет.

Тогда ждём, когда САН твёрдо скажет, что уже пока вставить текст по ссылке в РЭ,
т.к. до этого были его предложения сделать это в будущем - а настало ли уже это время? :-)

??? Тикет закрыт с резолюцией "не будем делать", то есть разработчиком РЭ уже принято решение полные настройки ethernet не описывать. Не понимаю, при чем тут, в таком случае, какое-то время... В любом случае я о наступлении времени ничего не знаю.

in reply to:  124 ; comment:125 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:
Ты написал:

Ответ на вопрос "..."

и дальше ничего нет - нет конца предложения, нет даже сказуемого (что делает ответ на этот вопрос?).

Это я хотел уточнить - на какой вопрос я не ответил и предположил, что ты имел ввиду вопрос:
"почему одни настройки описаны в одном документе, а другие вынесены в другой?",
но забыл поставить ещё один знак вопроса после кавычек, а ответ-пояснение было в следующих строчках.
Или ты имел ввиду другой вопрос?

Тогда ждём, когда САН твёрдо скажет, что уже пока вставить текст по ссылке в РЭ,
т.к. до этого были его предложения сделать это в будущем - а настало ли уже это время? :-)

??? Тикет закрыт с резолюцией "не будем делать", то есть разработчиком РЭ уже принято решение полные настройки ethernet не описывать. Не понимаю, при чем тут, в таком случае, какое-то время... В любом случае я о наступлении времени ничего не знаю.

Как тикет закрыт, так он может быть и переоткрыт в любой момент,
или я могу внести изменения после согласования с тобой или САН и при закрытом тикете,
и даже вообще без тикета. У меня гибкий подход к изменениям :-)

in reply to:  125 ; comment:126 by alx, 7 months ago

Replying to Vladimir:

Это я хотел уточнить - на какой вопрос я не ответил и предположил, что ты имел ввиду вопрос:
"почему одни настройки описаны в одном документе, а другие вынесены в другой?",
но забыл поставить ещё один знак вопроса после кавычек, а ответ-пояснение было в следующих строчках.
Или ты имел ввиду другой вопрос?

Спасибо, теперь понял. Я имел в виду другой вопрос - "Верно ли я понял, что ты больше так не считаешь?". Я думал, что это и так понятно, так как именно его ты процитировал перед своим текстом (я в comment:120 даже специально оставил эту цитату).

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

in reply to:  126 comment:127 by Vladimir, 7 months ago

Replying to alx:

Replying to Vladimir:
Спасибо, теперь понял. Я имел в виду другой вопрос - "Верно ли я понял, что ты больше так не считаешь?". Я думал, что это и так понятно, так как именно его ты процитировал перед своим текстом (я в comment:120 даже специально оставил эту цитату).

При появлении новых веских аргументов, которых я не знал, я всегда готов изменить своё мнение к лучшему
и предпочитаю согласованное со Знатоками решение.

in reply to:  126 comment:128 by Vladimir, 5 months ago

Replying to alx:

Replying to Vladimir:

Это я хотел уточнить - на какой вопрос я не ответил и предположил, что ты имел ввиду вопрос:
"почему одни настройки описаны в одном документе, а другие вынесены в другой?",
но забыл поставить ещё один знак вопроса после кавычек, а ответ-пояснение было в следующих строчках.
Или ты имел ввиду другой вопрос?

Спасибо, теперь понял. Я имел в виду другой вопрос - "Верно ли я понял, что ты больше так не считаешь?". Я думал, что это и так понятно, так как именно его ты процитировал перед своим текстом (я в comment:120 даже специально оставил эту цитату).

Это уже 128-й коммент и, чтобы больше не спорить, я добавил в редактируемое РЭ-59
"Приложение 15. Описание полной конфигурации Ethernet", САН это видел, не возразил
и согласился оставить в РЭ-59.

comment:129 by Vladimir, 4 months ago

Resolution: не будем делать
Status: closedreopened

comment:130 by Vladimir, 4 months ago

Resolution: готово
Status: reopenedclosed

В РЭ-59 добавлено:
"13.15 Приложение 15. Описание полной конфигурации Ethernet"

Теперь РЭ-59 увеличился до 460 страниц.
В РЭ-59 учтены и предыдущие предложения и тикеты.
Обновлённое РЭ уже выложено на нашем сайте и в наш Архив.

Читайте и пишите новые тикеты для следующей версии РЭ-60.

Note: See TracTickets for help on using tickets.