#620 closed улучшение (готово)
РЭ: неточная информация о столбце "Контакт" списка пользователей SIP плат VE-01/VE-02
Reported by: | alx | Owned by: | Vladimir |
---|---|---|---|
Priority: | minor | Component: | Руководство по эксплуатации |
Keywords: | Cc: |
Description (last modified by )
В РЭ аппаратуры MC04-DSL-3U редакции 41 в п 7.6 на странице 279 написано:
В поле Контакт отображается содержимое поля Contact в заголовке запроса user-агента к серверу регистрации;
Это правда, но это не вся правда. Кроме контакта в этом столбце также отображается (при наличии) название юзер-агента (содержимое поля User-Agent), что хорошо видно на рисунке 7.55.
Предлагаю добавить эту информацию в текст РЭ.
Change History (4)
follow-up: 2 comment:1 by , 5 years ago
comment:2 by , 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 , 5 years ago
Description: | modified (diff) |
---|---|
Resolution: | → готово |
Status: | new → closed |
Ну, если Алекс считает достаточным последний вариант текста
и что все пользователи (кроме меня :-) ) сходу, и правильно поймут весь этот пункт,
и никому не покажется странным сочетание "В поле Контакт отображается содержимое поля Contact", и никто не будет искать это "поле Contact"
то я закрою этот тикет, хотя для таких как я можно было бы и подробнее дать описание :-)
Задолго до моего пришествия в РЭ кто-то ввёл неписанное правило:
то, что в тексте часто ставили в кавычки, а именно названия кнопок и слов на рисунках,
обозначалось жирным шрифтом, а кавычки, если и были, то могли использоваться для иносказательных слов, например, я "лев" - это не в прямом смысле, а по гороскопу или по характеру, или в шутку,
либо для обозначения скопированной фразы из какого-то источника информации, либо прямая речь.
Вот я и продолжил эту уже традицию. Правда тогда слово Contact не должно быть жирным.
Написал это и сделал слово Contact в РЭ обычным шрифтом, чтобы никто больше не искал, как я, это слово на рисунках этого пункта.
Как-то для новичка непонятно звучит:
"В поле Контакт (это поле вижу в заголовке столбца) отображается содержимое поля Contact (это слово отмечено жирно, т.е. где-то на рисунке это слово должно бы быть либо в виде слова, либо кнопки, но я не смог найти это слово) в заголовке запроса user-агента (а я не знаю, где этот заголовок user-агента, а где что-то другое) к серверу регистрации;"
В Тикете:
"название юзер-агента (содержимое поля User-Agent)" Где это поле "User-Agent" на рисунке таких слов нет, кто такой "юзер-агент" - это человек? А "User-Agent" - это программа?
Тем не менее пока обновил для обсуждения фразу:
"В поле Контакт отображается содержимое поля Contact в заголовке запроса user-агента
к серверу регистрации, а также название юзер-агента (содержимое поля User-Agent);
"
Если этого достаточно, то закрою тикет.