![[MC-04 logo]](/mc-04/chrome/site/logo.png){kind=logo}
#890 closed улучшение (готово)
РЭ: MC-02 странная фраза
| Reported by: | san | Owned by: | Vladimir |
|---|---|---|---|
| Priority: | minor | Component: | Руководство по эксплуатации |
| Keywords: | Cc: | san, mixyil1.1, viktam |
Description
В РЭ-51 в п. "5.10.4 Настройка платы MC-02" есть такие фразы
Для настройки пакета VoIP сервера обратитесь к приложению Fusion PBX.
Для эксплуатации платы через SSH и базовым утилитам настроек операционной системы требуется обратиться к документации по установленной версии ОС
по моему тут какая-то путаница слов...Предлагаю переформулировать.
что такое пакет Voip? что за приложение? к чему приложение?
что такое эксплуатация через ssh?
Ещё не понятно как пользователь узнает что за ос установлена на плате, если мы отгружаем платы с установленной ОС и нигде не пишем с какой.
Attachments (1)
Change History (18)
comment:1 by , 3 years ago
follow-ups: 4 7 comment:2 by , 3 years ago
| Resolution: | → готово |
|---|---|
| Status: | new → closed |
Replying to san:
В РЭ-51 в п. "5.10.4 Настройка платы MC-02" есть такие фразы
Для настройки пакета VoIP сервера обратитесь к приложению Fusion PBX.
Для эксплуатации платы через SSH и базовым утилитам настроек операционной системы требуется обратиться к документации по установленной версии ОС
по моему тут какая-то путаница слов...Предлагаю переформулировать.
Линукс в пункте про МС-02 упоминается 3 раза:
"Плата работает под управлением операционной системы на базе Linux и имеет возможность установки стороннего программного обеспечения."
"MC-02 поддерживает операционные системы, базирующиеся на ядре Linux."
"Гибко и быстро наращиваемое программное обеспечение платы (OC Linux) позволяет плате выполнять большое число разнообразных функций:"
Windows тоже упоминается:
"В случае использования ОС Windows рекомендуется в качестве SSH-клиента использовать PuTTY."
что такое пакет Voip? что за приложение? к чему приложение?
Voip в новой редакции Тамашевича не упоминается совсем
что такое эксплуатация через ssh?
Про это теперь записано так:
"Для администрирования и настройки Операционной Системы платы MC-02 через IP сеть обычно используется SSH протокол. Для подключения можно использовать ...любой клиент SSH.
В случае использования ОС Windows рекомендуется в качестве SSH-клиента использовать PuTTY."
Ещё не понятно как пользователь узнает что за ос установлена на плате, если мы отгружаем платы с установленной ОС и нигде не пишем с какой.
Пишем 3 раза: "Плата работает под управлением операционной системы на базе Linux..."
"MC-02 поддерживает операционные системы, базирующиеся на ядре Linux."
"Гибко и быстро наращиваемое программное обеспечение платы (OC Linux) позволяет плате выполнять большое число разнообразных функций"
comment:3 by , 3 years ago
Replying to san:
В РЭ-51 в п. "5.10.4 Настройка платы MC-02" есть такие фразы...
В РЭ-52 полный текст этого пункта теперь такой:
"5.10.5 Настройка пакета программ, установленных на плате MC-02.
Для администрирования и настройки SIP сервера на базе пакета Fusion PBX (Freeswitch) следует руководствоваться документацией на сайте https://docs.fusionpbx.com и частичным переводом http://adc-line.ru/pdf/FusionPBX_ru.pdf.
Для администрирования и настройки Операционной Системы платы MC-02 через IP сеть обычно используется SSH протокол. Для подключения можно использовать любой клиент SSH.
В случае использования ОС Windows рекомендуется в качестве SSH-клиента использовать PuTTY."
Если надо подробнее, то уговори на это Тамашевича-Макаревича :-)
follow-up: 5 comment:4 by , 3 years ago
Replying to Vladimir:
Ещё не понятно как пользователь узнает что за ос установлена на плате, если мы отгружаем платы с установленной ОС и нигде не пишем с какой.
Пишем 3 раза: "Плата работает под управлением операционной системы на базе Linux..."
san почему-то на это не ответил, возможно, очень занят или просто пропустил, поэтому возьму смелость возразить на себя: в процитированной фразе не говорится, под управлением какой операционной системы работает плата!
"MC-02 поддерживает операционные системы, базирующиеся на ядре Linux."
san писал: "...что за ос установлена на плате", в процитированной же фразе говорится о том, какие операционные системы поддерживаются, а не установлены! К тому же здесь опять ни одна операционная система не названа...
"Гибко и быстро наращиваемое программное обеспечение платы (OC Linux) позволяет плате выполнять большое число разнообразных функций"
А эта фраза вообще неверна. Linux - не ОС.
PS. Уточнение - я имел в виду, что неверно написанное в скобках. Верна ли остальная часть фразы (позволяет ли гибко и быстро наращиваемое программное обеспечение выполнять плате большое число разнообразных функций), я не знаю.
follow-up: 6 comment:5 by , 3 years ago
Replying to alx:
Replying to Vladimir:
Ещё не понятно как пользователь узнает что за ос установлена на плате, если мы отгружаем платы с установленной ОС и нигде не пишем с какой.
Пишем 3 раза: "Плата работает под управлением операционной системы на базе Linux..."
san почему-то на это не ответил, возможно, очень занят или просто пропустил, поэтому возьму смелость возразить на себя: в процитированной фразе не говорится, под управлением какой операционной системы работает плата!
Вообще-то запись утвердительная:
""Плата работает под управлением операционной системы на базе Linux...""
Я бы так и понял, что "работает на базе Linux...",
а значит, Linux и установлен...
"MC-02 поддерживает операционные системы, базирующиеся на ядре Linux."
san писал: "...что за ос установлена на плате", в процитированной же фразе говорится о том, какие операционные системы поддерживаются, а не установлены! К тому же здесь опять ни одна операционная система не названа...
В первой фразе записано "... на базе Linux...",
т.е. не трудно понять что в базу могут входить и разные виды ОС с названием Linux
Википедия и Артём советуют записать "на базе ядра Linux".
А разве в микро-компьютере MC-02 нет никакой ОС? :-)
"Гибко и быстро наращиваемое программное обеспечение платы (OC Linux) позволяет плате выполнять большое число разнообразных функций"
А эта фраза вообще неверна. Linux - не ОС.
PS. Уточнение - я имел в виду, что неверно написанное в скобках. Верна ли остальная часть фразы (позволяет ли гибко и быстро наращиваемое программное обеспечение выполнять плате большое число разнообразных функций), я не знаю.
Всё что напечатано в РЭ про MC-02 - это Авторский текст Макаревичва и Тамашевича,
поэтому во всех тикетах про MC-02 ставь в копию Макаревича, т.к. я знаю про МС-02
гораздо меньше, чем ты, Макаревич, Тамашевич, САН, Артём и другие.
Добавь и к Этому тикету Макаревича и САН!
По этой плате (как и по твоим платам) я только оформитель текста в файле Word нашего РЭ ;-)
follow-up: 8 comment:6 by , 3 years ago
| Cc: | added |
|---|
Replying to Vladimir:
Ещё не понятно как пользователь узнает что за ос установлена на плате, если мы отгружаем платы с установленной ОС и нигде не пишем с какой.
Вообще-то запись утвердительная:
""Плата работает под управлением операционной системы на базе Linux...""
А у san в ответ на твою запись утвердительную - запись вопросительная: "с какой?". Ответа в твоей утвердительной записи нет...
Я бы так и понял, что "работает на базе Linux...",
а значит, Linux и установлен...
Это все, наверное, очень хорошо. Но какое это имеет отношение к вопросу san? Он спрашивал, как пользователь узнает, какая ОС (операционная система) установлена на плате. Я специально оставил вверху исходную цитату. Какая конкретно ОС установлена в MC-02, в приведенной тобой цитате не сообщается.
В первой фразе записано "... на базе Linux...",
Я очень рад, что там это написано, но к вопросу san это не имеет отношения. san не спрашивал, на базе чего сделана установленная в плате MC-02 ОС. Он спрашивал, что за ОС установлена на плате. Какая именно ОС. Ответа на этот вопрос в приведенной тобой цитате нет.
т.е. не трудно понять что в базу могут входить и разные виды ОС с названием Linux
Википедия и Артём советуют записать "на базе ядра Linux".
Это, наверное, чрезвычайно хорошо, но не отвечает на вопрос san, процитированный в начале этого комментария. Он не спрашивал, какие ОС могут быть установлены в MC-02. Он спрашивал, как пользователь узнает что за ос установлена на плате на момент отгрузки ее потребителю. Ни в одном из трех процитированных фрагментов ответа на этот вопрос нет.
А разве в микро-компьютере MC-02 нет никакой ОС? :-)
Вопрос не по адресу. Рекомендую задать его разработчику платы MC-02.
Добавь и к Этому тикету Макаревича и САН!
Хорошо, добавил. А почему ты не добавил их сам?
follow-up: 10 comment:7 by , 3 years ago
"MC-02 поддерживает операционные системы, базирующиеся на ядре Linux."
Возможно это фраза тоже не совсем точно подходит к описанию платы МС-02.
Плата МС-02 может поставляется с предустановленным образом ПО на SD карту, в зависимости от требуемого функционала. Этих "предустановленых" образов может быть несколько, те что мы используем в данный момент. Мини АТС - dietpi+FusionPBX, система оповещения - debian+"Система оповещения", система записи - cборка buildroot+"Система записи". Так же возможна поставка платы без образа, тогда на плату самостоятельно можно установить образ любой системы, которую поддерживает RPI3B+ (Raspberry Pi OS, Ubuntu, FreeBSD, OpenWRT и т.д.).
"Гибко и быстро наращиваемое программное обеспечение платы (OC Linux) позволяет плате выполнять большое число разнообразных функций:"
Тоже вероятно плохо сформулированно. Функционал платы не ограничен тем набором ПО, которое идет в поставке базового образа. Используя пакетный менеджер Linux можно расширить функционал установив дополнительно необходимое ПО.
Для администрирования и настройки Операционной Системы платы MC-02 через IP сеть обычно используется SSH протокол. Для подключения можно использовать любой клиент SSH.
На всех постоявляемых образах для получения доступа к консоли управления платы используется протокол SSH.
follow-ups: 13 14 15 comment:8 by , 3 years ago
Replying to alx:
Replying to Vladimir:
Вообще-то запись утвердительная:
""Плата работает под управлением операционной системы на базе Linux...""
А у san в ответ на твою запись утвердительную - запись вопросительная: "с какой?". Ответа в твоей утвердительной записи нет...
Я этого не знал и не знаю, текст скопировал из описания от Тамашевича,
другой информации у меня не было...
Я бы так и понял, что "работает на базе Linux...",
а значит, Linux и установлен...
Это все, наверное, очень хорошо. Но какое это имеет отношение к вопросу san? Он спрашивал, как пользователь узнает, какая ОС (операционная система) установлена на плате. Я специально оставил вверху исходную цитату. Какая конкретно ОС установлена в MC-02, в приведенной тобой цитате не сообщается.
Я не знаю...
В первой фразе записано "... на базе Linux...",
Я очень рад, что там это написано, но к вопросу san это не имеет отношения. san не спрашивал, на базе чего сделана установленная в плате MC-02 ОС. Он спрашивал, что за ОС установлена на плате. Какая именно ОС. Ответа на этот вопрос в приведенной тобой цитате нет.
Потому, что я не знаю и не могу знать, пока это не напишет истинный Автор ;-).
Это копия почти Авторского текста (от Тамашевича).
т.е. не трудно понять что в базу могут входить и разные виды ОС с названием Linux
Википедия и Артём советуют записать "на базе ядра Linux".
Это, наверное, чрезвычайно хорошо, но не отвечает на вопрос san, процитированный в начале этого комментария. Он не спрашивал, какие ОС могут быть установлены в MC-02. Он спрашивал, как пользователь узнает что за ос установлена на плате на момент отгрузки ее потребителю. Ни в одном из трех процитированных фрагментов ответа на этот вопрос нет.
И у меня тоже нет и не может быть ответа, пока это не сделает Автор.
А разве в микро-компьютере MC-02 нет никакой ОС? :-)
Вопрос не по адресу. Рекомендую задать его разработчику платы MC-02.
Добавь и к Этому тикету Макаревича и САН!
Хорошо, добавил. А почему ты не добавил их сам?
Если Тикет создаёшь ты, то у меня строка "Копия" не активна, пассивная, бледным шрифтом,
поэтому я не мог никого добавить...
Вот ты добавил и сразу появился коммент от Миши Макаревича!
Сейчас буду с ним создавать сотни комментов, пока он не напишет текст,
пригодный для копирования и вставки в РЭ без домысливания :-)
Это ещё раз говорит о том, что лучше, правильнее и точнее Автора вряд ли кто напишет,
тем более тот, кто столкнулся с этими вопросами первый раз за все 50 лет работы :-)
Это же относится и к платам VE :-).
comment:9 by , 3 years ago
| Cc: | added |
|---|
follow-up: 12 comment:10 by , 3 years ago
| Cc: | removed |
|---|
Replying to mixyil1.1:
"MC-02 поддерживает операционные системы, базирующиеся на ядре Linux."
Возможно это фраза тоже не совсем точно подходит к описанию платы МС-02.
Мне было бы удобнее отредактировать текст про МС-02 в РЭ,
если бы Вы совместно с Виктором Тамашевичем (или сам) исправили/дополнили его файл
описания платы МС-02, отправленный мне на прошлой неделе (21.12.2021):
"MC-02_mc04-dsl-3u-re_izmVT.rtf", с учётом комментов от Alex и САН,
чем объяснять мне и отвечать на мои некомпетентные вопросы.
Я не программист и никогда им не был, поэтому мне затруднительно сразу правильно сформулировать текст пункта "5.10 Плата MC-02 (микро-компьютер)" для вставки в РЭ с учётом Ваших объяснений и вопросов от Алекса и САН.
Плата МС-02 может поставляется с предустановленным образом ПО на SD карту, в зависимости от требуемого функционала. Этих "предустановленых" образов может быть несколько, те что мы используем в данный момент: мини АТС - dietpi+FusionPBX;система диспетчерской связи - dietpi+"Система диспетчерской связи"; система оповещения - debian+"Система оповещения"; система записи - cборка buildroot+"Система записи". Так же возможна поставка платы без образа, тогда на плату самостоятельно можно установить образ любой системы, которую поддерживает RPI3B+ (Raspberry Pi OS, Ubuntu, FreeBSD, OpenWRT и т.д.).
Не все юзеры могут знать терминологию на английском языке, поэтому в РЭ принято давать в скобках русскоязычный вариант или пояснение, что это такое (вот я, например, первый раз увидел слово Raspberry, а в словарях слишком много значений этого слова...).
"Гибко и быстро наращиваемое программное обеспечение платы (OC Linux) позволяет плате выполнять большое число разнообразных функций:"
Тоже вероятно плохо сформулированно. Функционал платы не ограничен тем набором ПО, которое идет в поставке базового образа. Используя пакетный менеджер Linux можно расширить функционал установив дополнительно необходимое ПО.
-- это и есть формулировка вместо существующей фразы?
Для администрирования и настройки Операционной Системы платы MC-02 через IP сеть обычно используется SSH протокол. Для подключения можно использовать любой клиент SSH.
На всех постоявляемых образах для получения доступа к консоли управления платы используется протокол SSH.
Это надо добавить к существующей фразе, или вместо неё и надо ли оставить фразу:
"Для подключения можно использовать любой клиент SSH."
Вам с Виктором проще бы написать готовый текст пункта 5.10 вместо советов и объяснений мне :-)
Авторский текст всегда лучше текста тех, кто никогда не занимался подобными вопросами ;-)
comment:11 by , 3 years ago
| Cc: | added |
|---|
comment:12 by , 3 years ago
Replying to Vladimir:
Replying to mixyil1.1:
"MC-02 поддерживает операционные системы, базирующиеся на ядре Linux."
Возможно это фраза тоже не совсем точно подходит к описанию платы МС-02.
Мне было бы удобнее отредактировать текст про МС-02 в РЭ,
если бы Вы совместно с Виктором Тамашевичем (или сам) исправили/дополнили его файл
описания платы МС-02, отправленный мне на прошлой неделе (21.12.2021):
"MC-02_mc04-dsl-3u-re_izmVT.rtf", с учётом комментов от Alex и САН,
чем объяснять мне и отвечать на мои некомпетентные вопросы.
Я не программист и никогда им не был, поэтому мне затруднительно сразу правильно сформулировать текст пункта "5.10 Плата MC-02 (микро-компьютер)" для вставки в РЭ с учётом Ваших объяснений и вопросов от Алекса и САН.
Мы поправим формуриловки в описании.
Плата МС-02 может поставляется с предустановленным образом ПО на SD карту, в зависимости от требуемого функционала. Этих "предустановленых" образов может быть несколько, те что мы используем в данный момент: мини АТС - dietpi+FusionPBX;система диспетчерской связи - dietpi+"Система диспетчерской связи"; система оповещения - debian+"Система оповещения"; система записи - cборка buildroot+"Система записи". Так же возможна поставка платы без образа, тогда на плату самостоятельно можно установить образ любой системы, которую поддерживает RPI3B+ (Raspberry Pi OS, Ubuntu, FreeBSD, OpenWRT и т.д.).
Не все юзеры могут знать терминологию на английском языке, поэтому в РЭ принято давать в скобках русскоязычный вариант или пояснение, что это такое (вот я, например, первый раз увидел слово Raspberry, а в словарях слишком много значений этого слова...).
Сложно найти русский аналог Raspberry Pi. Это название платы, а RPI3B+ соответсвенно сокращеное название конкретной модели (Raspberry Pi 3 Model B+). Данная модель и установленна на плате МС-02.
"Гибко и быстро наращиваемое программное обеспечение платы (OC Linux) позволяет плате выполнять большое число разнообразных функций:"
Тоже вероятно плохо сформулированно. Функционал платы не ограничен тем набором ПО, которое идет в поставке базового образа. Используя пакетный менеджер Linux можно расширить функционал установив дополнительно необходимое ПО.
-- это и есть формулировка вместо существующей фразы?
Если у Алекса и САН нет возражений, то я бы переписал эту фразу в такой формулировке.
Для администрирования и настройки Операционной Системы платы MC-02 через IP сеть обычно используется SSH протокол. Для подключения можно использовать любой клиент SSH.
На всех постоявляемых образах для получения доступа к консоли управления платы используется протокол SSH.
Это надо добавить к существующей фразе, или вместо неё и надо ли оставить фразу:
"Для подключения можно использовать любой клиент SSH."
Аналогично, если у Алекса и САН нет возражений, то эту формулировку я бы использовал вместо всей предыдущей фразы.
Вам с Виктором проще бы написать готовый текст пункта 5.10 вместо советов и объяснений мне :-)
Авторский текст всегда лучше текста тех, кто никогда не занимался подобными вопросами ;-)
comment:13 by , 3 years ago
Replying to Vladimir:
А у san в ответ на твою запись утвердительную - запись вопросительная: "с какой?". Ответа в твоей утвердительной записи нет...
Я этого не знал и не знаю, текст скопировал из описания от Тамашевича,
другой информации у меня не было...
В описании тикета san написал:
Ещё не понятно как пользователь узнает что за ос установлена на плате, если мы отгружаем платы с установленной ОС и нигде не пишем с какой.
На это ты возразил в comment:2: "Пишем 3 раза", и привел три цитаты, ни в одной из которых не говорится, какая ОС установлена на отгружаемую плату.
Какая конкретно ОС установлена в MC-02, в приведенной тобой цитате не сообщается.
Я не знаю...
Не знаешь чего? Сообщается ли в приведенной тобой цитате, какая ОС установлена на плате MC-02? :)
Какая именно ОС. Ответа на этот вопрос в приведенной тобой цитате нет.
Потому, что я не знаю и не могу знать, пока это не напишет истинный Автор ;-).
Но это не помешало тебе утверждать, что мы пишем, с какой ОС отгружается плата. :)
Ни в одном из трех процитированных фрагментов ответа на этот вопрос нет.
И у меня тоже нет и не может быть ответа, пока это не сделает Автор.
Зачем же ты утверждал, что мы потребителю это пишем? :)
comment:14 by , 3 years ago
Replying to Vladimir:
Если Тикет создаёшь ты, то у меня строка "Копия" не активна, пассивная, бледным шрифтом,
поэтому я не мог никого добавить...
Я этот тикет не создавал. Судя по надписи "Сообщил: san", его создал san.
follow-up: 16 comment:15 by , 3 years ago
Replying to Vladimir:
Если Тикет создаёшь ты, то у меня строка "Копия" не активна, пассивная, бледным шрифтом,
поэтому я не мог никого добавить...
Вижу, что ты успешно убрал и затем снова добавил viktam в Копию. Проблема со строкой "Копия" решилась?
comment:16 by , 3 years ago
Replying to alx:
Replying to Vladimir:
Если Тикет создаёшь ты, то у меня строка "Копия" не активна, пассивная, бледным шрифтом,
поэтому я не мог никого добавить...
Вижу, что ты успешно убрал и затем снова добавил viktam в Копию. Проблема со строкой "Копия" решилась?
Да, нашёл "заветное" место, где можно это сделать :-)
comment:17 by , 3 years ago
Поправил описание платы МС-02. Измененный файл во вложении. Красным отмечены куски для удаления, зеленым новое описание.
Replying to san:
Я про Эту плату знаю только со слов авторов/соавторов, в частности, от В.Тамашенича,
который и прислал мне это описание в файле "Плата MC-02_VT-ver1.docx" от 31.03.2021,
а я, не зная ничего более про Эту плату, мог только скопировать Авторский текст
и вставить в РЭ, полагая, что Автор лучше меня знает эту тему.
Эти вопросы я перешлю Тамашевичу, а Приложение "Fusion PBX" он уже прислал:
это 42 страницы текста с рисунками - добавить к нашим 386 страницам РЭ
Текст и смысл этого Приложения я оценить не могу, но в этом Приложении все гиперссылки на какие-то сайты с длинными названиями у меня не открываются.
Все первоисточники - на английском языке, а Приложение Fusion PBX -
это, как я понял, перевод от Тамашевича (файл "Приложение №1 Fusion PBX.docx").
Чтобы не было "испорченного телефона" через третье лицо (т.е. через меня),
лучше бы с Тамашевичем поговорил кто-то из наших знатоков по этой теме...
Текст про МС-02 вставлен в РЭ по принципу:
"Чтобы было и все видели, что это есть!" :-)
По мере поступления новой информации предполагалось корректировать текст,
но для меня это "то, не знаю чего" и надеюсь только на помощь Авторов и наших Знатоков :-)