Opened 5 years ago

Closed 5 years ago

Last modified 22 months ago

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

РЭ: неточная информация о столбце "Контакт" списка пользователей SIP плат VE-01/VE-02 — at Version 3

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

Description (last modified by Vladimir)

В РЭ аппаратуры MC04-DSL-3U редакции 41 в п 7.6 на странице 279 написано:

В поле Контакт отображается содержимое поля Contact в заголовке запроса user-агента к серверу регистрации;

Это правда, но это не вся правда. Кроме контакта в этом столбце также отображается (при наличии) название юзер-агента (содержимое поля User-Agent), что хорошо видно на рисунке 7.55.

Предлагаю добавить эту информацию в текст РЭ.

Change History (3)

comment:1 by Vladimir, 5 years ago

Как-то для новичка непонятно звучит:
"В поле Контакт (это поле вижу в заголовке столбца) отображается содержимое поля Contact (это слово отмечено жирно, т.е. где-то на рисунке это слово должно бы быть либо в виде слова, либо кнопки, но я не смог найти это слово) в заголовке запроса user-агента (а я не знаю, где этот заголовок user-агента, а где что-то другое) к серверу регистрации;"

В Тикете:
"название юзер-агента (содержимое поля User-Agent)" Где это поле "User-Agent" на рисунке таких слов нет, кто такой "юзер-агент" - это человек? А "User-Agent" - это программа?

Тем не менее пока обновил для обсуждения фразу:

"В поле Контакт отображается содержимое поля Contact в заголовке запроса user-агента
к серверу регистрации, а также название юзер-агента (содержимое поля User-Agent);
"
Если этого достаточно, то закрою тикет.

in reply to:  1 comment:2 by alx, 5 years ago

Replying to Vladimir:

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

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

на рисунке таких слов нет,

Я и не говорил (в описании тикета такого не написано), что в столбце "Контакт" также отображаются слова "User-Agent". Я написал (и ты это только что процитировал) "содержимое поля User-Agent", а не "слова User-Agent". А содержимое этого поля вовсе не обязано содержать слова "User-Agent".

Где это поле "User-Agent"

Это поле - в заголовке сообщения REGISTER, которое клиент присылает нашей плате при регистрации.

кто такой "юзер-агент" - это человек?

Нет, это не человек.

А "User-Agent" - это программа?

Да, это программа. Подробнее можно прочитать в статье в википедии.

Тем не менее пока обновил для обсуждения фразу:

"В поле Контакт отображается содержимое поля Contact в заголовке запроса user-агента
к серверу регистрации, а также название юзер-агента (содержимое поля User-Agent);
"
Если этого достаточно, то закрою тикет.

Думаю, этого вполне достаточно.

comment:3 by Vladimir, 5 years ago

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

Ну, если Алекс считает достаточным последний вариант текста
и что все пользователи (кроме меня :-) ) сходу, и правильно поймут весь этот пункт,
и никому не покажется странным сочетание "В поле Контакт отображается содержимое поля Contact", и никто не будет искать это "поле Contact"
то я закрою этот тикет, хотя для таких как я можно было бы и подробнее дать описание :-)

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

Note: See TracTickets for help on using tickets.