Opened 6 weeks ago

Closed 6 weeks ago

Last modified 5 weeks ago

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

РЭ: улучшить описание работы параметра "Прекратить поиск после нахождения маршрутов"

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

Description (last modified by alx)

В платах VE-01 и VE-02 есть конфигурационный параметр "Прекратить поиск после нахождения маршрутов", который определяет поведение прокси-сервера в случае, если вызовы найденных маршрутов SIP были неудачны. Выяснилось (см. тикет), что один из пользователей неверно понял описание работы данного параметра - он думал, что обработка вызова прекратится после нахождения первого же совпадающего маршрута SIP из нескольких имеющихся (пользователь настроил резервирование, и у него вызываемый URI совпадал сразу c несколькими маршрутами SIP).

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

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

Или, возможно, имелось в виду "хотя бы один маршрут"...

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

Change History (20)

comment:1 by alx, 6 weeks ago

Description: modified (diff)

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

Replying to alx:

... В примере, использованном в описании этого параметра, вызов совпадает только с одним маршрутом. К тому же в первом предложении описания (см. РЭ-67 п. 7.1.4.2 на странице 249), видимо, по ошибке слово "маршрут" употреблено в единственном, а не множественном числе (предполагаю, что это и запутало пользователя):

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

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

Или, возможно, имелось в виду "хотя бы один маршрут"...

Что ты имел ввиду, когда сочинял Вики я не знаю, но записал множественное число :-)

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

Эта ссылка у меня не открывается, а ругается и посылает меня очень далеко::
"Ошибка Trac
Can't view wiki:"unctionsSipRouting". Resource doesn't exist or you don't have the required permission.
TracGuide — The Trac User and Administration Guide".

in reply to:  2 ; comment:3 by alx, 6 weeks ago

Description: modified (diff)

Replying to Vladimir:

...видимо, по ошибке слово "маршрут" употреблено в единственном, а не множественном числе > Не по ошибке, т.к. я и не знал, а просто скопировал из вики,

но в редактируемом РЭ-69 уже записал множественное число ...

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

За основу можно взять эту статью

Эта ссылка у меня не открывается,

Прошу прощения. Исправил опечатку.

in reply to:  3 ; comment:4 by Vladimir, 6 weeks ago

Replying to alx:

Replying to Vladimir:

...видимо, по ошибке слово "маршрут" употреблено в единственном, а не множественном числе > Не по ошибке, т.к. я и не знал, а просто скопировал из вики,

но в редактируемом РЭ-69 уже записал множественное число ...

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

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

За основу можно взять эту статью

Эта ссылка у меня не открывается,

Прошу прощения. Исправил опечатку.

Так и снова эта ссылка не открывается, а вот Ссылка из тикета-444 от san на твою вики открылась:
https://trac.adc-line.ru/sip_ua/wiki/FunctionsSipRouting#%D0%94%D0%B2%D0%B0%D1%80%D0%B5%D0%B6%D0%B8%D0%BC%D0%B0%D0%BF%D0%BE%D0%B8%D1%81%D0%BA%D0%B0%D1%86%D0%B5%D0%BB%D0%B8

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

in reply to:  4 ; comment:5 by alx, 6 weeks ago

Replying to Vladimir:

Эта ссылка у меня не открывается,

Прошу прощения. Исправил опечатку.

Так и снова эта ссылка не открывается,

У меня открывается. Думаю, у тебя опять какие-то проблемы с настройками компьютера...

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

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

это же надо помнить всю жизнь и не забывать об этой особенности

Во-первых, я ничего помнить не предлагал.

Во-вторых, в том чтобы что-то помнить всю жизнь, нет ничего страшного и/или сверхъестественного. Большинство людей, например, еще в раннем детстве выучивают буквы и цифры и как-то умудряются всю жизнь их потом помнить, и я ни разу не слышал чтобы кто-то на такую необходимость жаловался... :)

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

Если у тебя есть предложение о том, как сделать интерфейс более дружественным, создай тикет в проекте sw-01, и мы там обсудим детали твоего предложения.

Last edited 6 weeks ago by alx (previous) (diff)

comment:6 by san, 6 weeks ago

У меня открывается. Думаю, у тебя опять какие-то проблемы с настройками компьютера...

Думаю что В.А. пытается открыть не исходную ссылку, которая была исправлена, а ссылку в одной из цитат, которые не были исправлены.

in reply to:  5 ; comment:7 by Vladimir, 6 weeks ago

Resolution: готово
Status: newclosed

Replying to alx:

Replying to Vladimir:
Мое дело - предложить. Если тебе и юзерам это не нравится - создавайте закольцованные маршруты, дело ваше. :)

Это недоброжелательное отношение у юзерам :-)

А тикет для своих творений ты можешь создать создать самому себе "на память" сам,
как, например, это делает san - у него штук 15 таких тикетов, где он и "сообщатель" и владелец :-)

Во-первых, я ничего помнить не предлагал.

Не предлагал, но юзеры вынуждены будут запоминать, чтобы успешно работать с твоим софтом :-)

Во-вторых, в том чтобы что-то помнить всю жизнь, нет ничего страшного и/или сверхъестественного. Большинство людей, например, еще в раннем детстве выучивают буквы и цифры и как-то умудряются всю жизнь их потом помнить, и я ни разу не слышал чтобы кто-то на такую необходимость жаловался... :)

С возрастом запоминать труднее, особенно для таких РЭ, в которых 150 тысяч слов :-)

Интерфейс должен быть дружественным, подсказывать об ошибках и их решении.

Если у тебя есть предложение о том, как сделать интерфейс более дружественным, создай тикет в проекте sw-01, и мы там обсудим детали твоего предложения.

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

По этому тикету я уже добавил в РЭ-69 текст про "Прекратить поиск после нахождения маршрутов",
в РЭ-69 добавилась ещё 1 страница, теперь уже 487 страниц - это благодаря твоим стараниям
получается такое подробное РЭ!
РЭ-68 уже опубликовано на сайте и выложено в Архив АДС, там добавилось ещё 1 изделие MC04-DSL-2UH-O1,
ну и много другого из тикетов. Пиши новые замечания-предложения :-)

in reply to:  7 ; comment:8 by alx, 6 weeks ago

Replying to Vladimir:

Во-первых, я ничего помнить не предлагал.

Не предлагал, но юзеры вынуждены будут запоминать, чтобы успешно работать с твоим софтом :-)

Чтобы работать с моим софтом, ничего запоминать не требуется.

Если у тебя есть предложение о том, как сделать интерфейс более дружественным, создай тикет в проекте sw-01, и мы там обсудим детали твоего предложения.

Так ты же идею уже понял

Я не знаю, о какой идее ты говоришь. За последние несколько дней я ни одного созданного тобой тикета не видел.

и сам для своего софта можешь сочинить себе тикет более грамотно :-)

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

Пиши новые замечания-предложения :-)

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

in reply to:  8 ; comment:9 by Vladimir, 5 weeks ago

Replying to alx:

Replying to Vladimir:

Во-первых, я ничего помнить не предлагал.

Не предлагал, но юзеры вынуждены будут запоминать, чтобы успешно работать с твоим софтом :-)

Чтобы работать с моим софтом, ничего запоминать не требуется.

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

Если у тебя есть предложение о том, как сделать интерфейс более дружественным, создай тикет в проекте sw-01, и мы там обсудим детали твоего предложения.

Так ты же идею уже понял

Я не знаю, о какой идее ты говоришь. За последние несколько дней я ни одного созданного тобой тикета не видел.

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

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

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

Last edited 5 weeks ago by Vladimir (previous) (diff)

in reply to:  9 ; comment:10 by alx, 5 weeks ago

Replying to Vladimir:

Чтобы работать с моим софтом, ничего запоминать не требуется.

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

А еще в том же самом тикете я предложил написать об этом в РЭ, а ты, по твоим же собственным словам, это предложение принял и реализовал. Поэтому это запоминать не требуется.

А без тикета ты принципиально не хочешь улучшить свой же софт? :-)

Часто я улучшаю и без тикета.

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

Прости, не понял вопрос... Лучше чем что?

in reply to:  10 ; comment:11 by Vladimir, 5 weeks ago

Replying to alx:

Replying to Vladimir:
А еще в том же самом тикете я предложил написать об этом в РЭ, а ты, по твоим же собственным словам, это предложение принял и реализовал. Поэтому это запоминать не требуется.

Тогда требуется искать нужное место в огромном РЭ, что тоже неудобно...

А без тикета ты принципиально не хочешь улучшить свой же софт? :-)

Часто я улучшаю и без тикета.

Вот и хорошо!

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

Прости, не понял вопрос... Лучше чем что?

Лучше сделать софт по возможности с контролем правильности действий юзера
и подсказками для устранения ошибок, чем без этих удобств :-)
Например, если софт увидел закольцованность маршрутов, то сразу бы и предупредил юзера об этом,
а в идеале ещё по-дружески и предложил бы варианты возможных решений :-)
Попробуй в Экселе набрать неправильную формулу и он по дружбе подчеркнёт/подскажет :-)

in reply to:  11 ; comment:12 by alx, 5 weeks ago

Replying to Vladimir:

Тогда требуется искать нужное место в огромном РЭ, что тоже неудобно...

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

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

Прости, не понял вопрос... Лучше чем что?

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

Да, лучше.

Попробуй в Экселе набрать неправильную формулу и он по дружбе подчеркнёт/подскажет :-)

Не могу, у меня нет Экселя.

in reply to:  12 ; comment:13 by Vladimir, 5 weeks ago

Replying to alx:

Replying to Vladimir:

Тогда требуется искать нужное место в огромном РЭ, что тоже неудобно...

А это - подмена тезиса. Мы не обсуждали удобство или неудобство.

Это попутно: если удобно, то это же лучше! :-)

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

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

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

Да, лучше.

А сделать это очень-очень трудно или даже невозможно? :-)

Попробуй в Экселе набрать неправильную формулу и он по дружбе подчеркнёт/подскажет :-)

Не могу, у меня нет Экселя.

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

in reply to:  13 ; comment:14 by alx, 5 weeks ago

Replying to Vladimir:

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

Да, лучше.

А сделать это очень-очень трудно или даже невозможно? :-)

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

in reply to:  14 ; comment:15 by Vladimir, 5 weeks ago

Replying to alx:

Replying to Vladimir:

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

Да, лучше.

А сделать это очень-очень трудно или даже невозможно? :-)

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

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

in reply to:  15 ; comment:16 by alx, 5 weeks ago

Replying to Vladimir:

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

??? Я тебе этого не предлагал. Что я предлагал, написано в описании тикета после выделенного жирным шрифтом слова "предлагаю":

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

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

in reply to:  16 ; comment:17 by Vladimir, 5 weeks ago

Replying to alx:

Replying to Vladimir:

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

??? Я тебе этого не предлагал. Что я предлагал, написано в описании тикета после выделенного жирным шрифтом слова "предлагаю":

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

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

Так это же по сути моё встречное предложение:
Исключить на программном уровне возможность создания "закольцованных" маршрутов,
ну или хотя бы сразу предупреждать юзера о появлении "закольцованных" маршрутов :-)
А то, что ты предлагал, я уже давно выполнил (около 10 комментов назад).

in reply to:  17 comment:18 by alx, 5 weeks ago

Replying to Vladimir:

Так это же по сути моё встречное предложение:

Во-первых, если ты пишешь о своем предложении, то почему пишешь "ты предлагаешь"?

Во-вторых, я тебе в comment:5 уже писал, что если у тебя есть предложение о том, как улучшить веб-интерфейс, создай тикет в проекте ​sw-01. Если есть предложение по улучшению платы VE-xx, создай тикет в проекте sip_ua. А комментарии в тикете на постороннюю тему, да еще в другом проекте - неподходящее для таких предложений место. Этот тикет - про улучшение РЭ, а не аппаратуры.

in reply to:  16 ; comment:19 by alx, 5 weeks ago

Replying to Vladimir:

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

И, кстати, если под "тут" подразумевается поле "Регулярное выражение target URI" в диалоге маршрута SIP, то красный фон, который я привел в качестве примера, тут есть - попробуй ввести туда некорректное регулярное выражение!

Last edited 5 weeks ago by alx (previous) (diff)

in reply to:  19 comment:20 by Vladimir, 5 weeks ago

Replying to alx:

Replying to Vladimir:

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

И, кстати, если под "тут" подразумевается поле "Регулярное выражение target URI" в диалоге маршрута SIP, то красный фон, который я привел в качестве примера, тут есть - попробуй ввести туда некорректное регулярное выражение!

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

Note: See TracTickets for help on using tickets.