«Тестирование» руководства пользователя
Решили тут на днях провести «тестирование» одного из разделов руководства пользователя для нашего прибора Беркут-ЕТ. Раздел посвящён проведению асимметричного теста и содержит схему подключения прибора, описание пунктов меню и порядок действий для проведения анализа.
Основным условием тестирования было то, что тестировщиком должен быть человек, никогда ранее не читавший руководство и не проводивший асимметричный тест. Раздел руководства был распечатан и передан для предварительного изучения коллеге из отдела конструкторов, задачей которого было попытаться самостоятельно провести описанный в руководстве тест. Также было предоставлено все необходимое для подключения прибора по схеме, описанной в руководстве.
Итак, после того, как материал был изучен, прибор подключен в соответствии со схемой, осталось выполнить указания из руководства и провести анализ. Что, к сожалению, вызвало некоторые трудности, т.к. оказалось, что подробно были описаны не все настройки прибора.
В результате решили:
— по возможности описать все трудности, с которыми может столкнуться пользователь при настройке прибора;
— пореже отсылать пользователя к материалам, описанным в предыдущих разделах;
— увеличить количество поясняющих скриншотов;
— привести не абстрактный, а конкретный пример проведения тестирования.
Полученное описание снова было показано пользователю и признано более понятным. Но, как говорится, нет предела совершенству. ;)
Проведя такое «тестирование» документации мы ещё раз убедились в том, что не все то, что понятно программистам и техническому писателю понятно пользователю.
Итак, вперёд, к более подробной и, следовательно, понятной для пользователя документации!
P.S. Большое спасибо тестировщику за дельные советы и интересные идеи. :)
P.P.S. А еще оказалось, что тестирование руководства пользователя полезно и для программистов: в результате тестирования было решено упростить для понимания
пользователя один из пунктов меню прибора.
А ещё хорошо бы раздел про обновление прошивки переписать вообще. Я обновление проводил всего-то раз пять, всё время листал руководство и сайт и путался. Даже удивительно что только сейчас прибор убил до незагружаемого состояния :-(
наверное, надо переписать. и перепишем.
а как убить-то удалось?
Что-то тут не то с комментированием, похоже. Пишу комментарий, говорит неверный код, давайте заново. Ввожу новосгенерированный код, говорит «Код правильный, но дубликат комментария удалён» О_о
Причём комментарий с «неверным кодом» добавился таки.
а можно узнать, что именно вызвало трудности при обновлении прошивки в соответствии с описанием из руководства пользователя?
Надо писать подробно.
А то для приборов до номера такого -так, а других -этак.
Причем еще надо обновить это, а на сайте ни слова.
Обновил один удачно, через несколько месяцев второй — труп. :(
А с чем конкретно были затруднения? Непонятно, как определить версию загрузчика?
в ближайшее время перепишем информацию, представленную на сайте, более подробно.
о готовности сообщим заметкой на блоге. :)
что бы перешить до последней версии надо было сперва загрузить b3et-bootldr_0.0.10.bin в беркут которого не было на сайте
Это выяснилось после звонка к Вам.
Но перешил его удачно. Вот с вторым — не получилось.
перешивка бутлоадера — опасная операция. в любом устройстве. поэтому пользователь делает это на свой страх и риск.
но вот то, что мы в инструкции об этом ничего не написали — безобразие.
присылайте нам. восстановим.
Сорри. Пытался залить лоадер от ет со всеми вытекающими.:(
Спасибо Павлу за советы и пинок в нужном направлении.
Прошили,обновили,все работает. :)