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

[alx]

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

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

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

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

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

[Vladimir]

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".

[alx]

Replying to Vladimir:

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

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

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

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

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

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

[Vladimir]

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 лет (срок службы аппаратуры) все об этом забудут:
разве абсолютно нельзя сделать так, чтобы при попытке случайно закольцевать появлялось бы сообщение,
что так делать нельзя? Интерфейс должен быть дружественным, подсказывать об ошибках и их решении.

[alx]

Replying to Vladimir:

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

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

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

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

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

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

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

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

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

разве абсолютно нельзя сделать так, чтобы при попытке случайно закольцевать появлялось бы сообщение, что так делать нельзя?

Что ты подразумеваешь под "попыткой случайно закольцеать"?

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

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

[san]

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

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

[Vladimir]

Replying to alx:

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

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

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

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

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

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

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

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

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

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

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

[alx]

Replying to Vladimir:

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

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

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

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

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

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

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

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

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

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

[Vladimir]

Replying to alx:

Replying to Vladimir:

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

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

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

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

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

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

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

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

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

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

[alx]

Replying to Vladimir:

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

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

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

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

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

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

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

[Vladimir]

Replying to alx:

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

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

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

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

Вот и хорошо!

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

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

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

[alx]

Replying to Vladimir:

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

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

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

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

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

Да, лучше.

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

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

[Vladimir]

Replying to alx:

Replying to Vladimir:

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

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

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

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

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

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

Да, лучше.

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

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

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

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

[alx]

Replying to Vladimir:

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

Да, лучше.

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

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

[Vladimir]

Replying to alx:

Replying to Vladimir:

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

Да, лучше.

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

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

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

[alx]

Replying to Vladimir:

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

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

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

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

[Vladimir]

Replying to alx:

Replying to Vladimir:

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

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

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

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

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

[alx]

Replying to Vladimir:

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

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

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

[alx]

Replying to Vladimir:

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

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

[Vladimir]

Replying to alx:

Replying to Vladimir:

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

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

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