id summary reporter owner description type status priority component resolution keywords cc 541 РЭ: ошибки в описании процесса обновления ПО аппаратуры MC04-DSL-3U alx Vladimir "В РЭ аппаратуры MC04-DSL-3U редакции 39 в разделе 6.2.26 на странице 186 описаны способы обновления ПО. В описании я вижу много ошибок, а также непоследовательность и неполноту описания. В описании варианта обновления с сайта предприятия-изготовителя указан хост www.adc-line.ru. Это неверно. Серчер предприятия-изготовителя, на котором находится репозиторий, имеет имя хоста repo.adc-line.ru. Далее говорится, что для обновления с сайта предприятия-изготовителя необходимо скачать пакеты обновлений с сайта предприятия-изготовителя по ссылке http://adc-line.ru/catalog/msan/3u/. Во-первых, указанная ссылка ведет на веб-страницу описания аппаратуры MC04-DSL-3U, и никаких пакетов там нет. Во-вторых, для обновления с сайта предприятия-изготовителя ничего скачивать не надо. Аппаратура сама скачает все, что ей необходимо для обновления. Все, что нужно сделать для обновления ПО - это нажать кнопку ""Проверить обновления"", а затем, после завершения проверки, нажать ""Установить выбранные пакеты"". Далее написано: //Там же прилагается подробная инструкция, как осуществить обновление.// Непонятно, где ""там""? На сервере предприятия-изготовителя? Так читатель уже читает руководство по эксплуатации, полученное с сайта предприятия-изготовителя (чем не инструкция?)! Не лучше ли описать процесс прямо там, не отсылая к каким-то другим источникам? Далее написано: //Также возможно использование стороннего сервера, поддерживающего протоколы HTTP или FTP.// Это правда, но это не вся правда. Кроме перечисленных протоколов также поддерживается обновление по протоколу HTTPS. Далее написано: //Пакеты обновлений на сторонний сервер можно загрузить с сайта предприятия-изготовителя, используя команду wget -m -nH -cut-dirs=2 http://adc-line.ru/feeds/sw-01/ipk. Здесь (кроме замены URL, о которой я писал выше) я бы добавил ""например"": //загрузить с сайта предприятия-изготовителя, **например**, используя команду wget// чтобы подчеркнуть, что это всего лишь один из возможных примеров, и читатель может копировать наш репозиторий теми инструментами и теми способами, какие ему более удобны. Далее подробно описан, собственно, процесс обновления. Мне не нравится такая компоновка информации. В самом начале читателю сообщается, что самый простой способ обновления - это обновление непосредственно из репозитория АДС. Однако прежде чем он прочитает о том, как же этот самый простой вариант делается, он видит целую кучу ненужной в этом случае информации, типа как можно скачать копию репозитория на свой компьютер. Мне кажется, более удобным для читателя было бы сначала полностью описать самый простой способ - обновление из репозитория АДС. То после указания, что это самый простой способ, сразу написать: ""Нажмите кнопку **Проверить обновления** (строка **URL для обновления** должна оставаться пустой)..."" и т.д. А затем написать: ""если доступ платы SW-01 к репозиторию АДС по каким-то причинам невозможен, можно выполнить обновления с любого другого сервера, к которому доступ есть"". Далее описать, как сделать копию репозитория, как проще поднять свой сервер и т.п. А затем написать что-то типа: ""Укажите в строке **URL для обновления** путь к копии репозитория, а далее следуйте описанной выше процедуре обновления из репозитория АДС"". При такой компоновке материала те, кто может обновиться напрямую через интернет, могут просто не читать оставшийся текст о том, как поднимать свой сервер и копировать репозиторий... Далее есть такой текст: //Возможно несерийное обновление ПО в плате SW-01...// Лично мне здесь непонятно слово ""несерийное"". Из этого текста вытекает вывод, что обновление ПО может быть ""серийное"" и ""несерийное"". Но что это означает, и в чем различие этих категорий, в тексте РЭ не поясняется. Подозреваю, что это слово будет непонятно не только мне, но и другим читателям РЭ, поэтому предлагаю либо добавить разъяснение, что такое ""серийный"" и ""несерийные"" обновления, либо исключить слово ""несерийное"" из текста РЭ. Наконец, в самом начале п. 6.2.26 говорится о трехисточниках обновления: - //сервер обновлений на сайте предприятия-изготовителя;// - //сторонний сервер;// - //локальный компьютер.// Два первых пункта понятны и описаны. Третий, насколько я понял - это установка отдельных пакетов через веб-интерфейс (кнопка ""Установить .ipk""). Если так, то предлагаю сформулировать эти варианты более точно, например так: - из репозитория АДС через интернет: - из копии репозитория на стороннем сервере; - установка отдельных пакетов через веб-интерфейс. " дефект closed major Руководство по эксплуатации готово