Тех. Документация - ux beyond ui

17
UX SPb «Кодекс» Юрий Солоницын 10.12.2013 Санкт- Петербург

Upload: yury-solonitsyn

Post on 24-Jan-2015

307 views

Category:

Education


9 download

DESCRIPTION

Хорошая техническая документация окружает программный продукт - помогает его проектировать и продавать, помогает его осваивать, помогает его поддерживать и продолжать разработку. Документация определяет User Experience или Customer Experience далеко за пределами пользовательского интерфейса. Презентация к выступлению на встрече UX-специалистов в консорциуме Кодекс.

TRANSCRIPT

UX SPb «Кодекс» Юрий Солоницын10.12.2013Санкт-Петербург

Ежегодная конференция по юзабилитии проектированию взаимодействия (UX)

26 апреля 2014 , Санкт-Петербургwww.profsoux.ru

Важно запомнить!

1. Прежде всего – контекст применения!

2. Догм нет! (даже по ГОСТ)

Догма

Документация — UX beyond UI

User Experience / Customer Experience – части компенсируют недостатки друг друга

Качество изготовления продукта

Расширяемость

Документация Обучение

Интеграция

Простота развертывания

Техническая поддержка

Качество обслуживания

Возможность применения по назначению= Usability

Пользовательский интерфейс (UI)

Виды технической документации

Документация

Договорная

Проектная

Программная

Пользовательская

ТЗ, методики испытаний;

Отчеты, пояснительные записки, спецификации, требования и т.д.

Описания программ и алгоритмов;КД (чертежи, схемы и т.д.);

Руководства, инструкции, data sheet,online help и т.д.

Документы тоже проектируют

Для кого?

Зачем?

Заинтересованные лица, целевая аудитория. Уровень подготовки и зона ответственности.

Задачи, решаемые заинтересованным лицом при помощи документа.

Какие задачи мы ставим перед создаваемыми документами?

Объяснить Научить Защитить

От полноты информации зависит успешность применения продукта,а значит его репутация и репутация разработчиков.

Целевая аудитория – Лица, принимающие решение

Что это?

Зачем оно моей компании?

Какими функциями обладает продукт?

Мы сможем его применить?

Когда его не надо применять?

Чем внедрение поможет нам?

Подойдет ли продукт нашей компании?

Спасибо, что предупредили!А то мы бы нарвались …

Важно не просто продать, а продать полезный продукт.

Целевая аудитория – Технический персонал заказчика

Что это?

Что мне с ним делать?

Какими функциями обладает продукт?

Как от него избавиться?

Как научить других?

Как правильно развернуть и настроить?

Вдруг станет не нужен или понадобится обновить?

У меня тут пользователи еще …

Что делать не надо?Как мне его не сломать?

Что только не вытворяет админ, если его не предупредить.

Целевая аудитория – Пользователи

Что это?

Что мне с ним делать?

Какими функциями обладает продукт?

Как использовать?

Как мне его не сломать?Что делать не надо?

Если продукт предназначен для домашнего использования, эта группа читателей будет основной. Понадобится информация о преимуществах продуктаи о его настройке.

Целевая аудитория – Техническая поддержка

Что это?

Что с ним можно делать?

Какими функциями обладает продукт? Что о нем можно рассказать?

Как пользователям решить их задачи? Что делать, если что-то пошло не по плану? (это и есть план ;))

О чем надо предупредить?Что делать не надо?

Квалификация службы поддержки зависит от качества обучения.

Целевая аудитория – Разработчики

Что это?

Что с ним можно делать?

А то сами уже забыли…

Надо рассказать руководству, поддержке, отделу маркетинга …

О чем надо предупредить?Что делать не надо?

Проще показать документ, чем самим вспоминать и объяснять.

Как с ним обращаться,

Надо научить сотрудников поддержки.

Зачем? Контекст и еще раз контекст

End-user, SOHO

Enterprise

Наш пользователь один на один с нашим продуктом, надо ему помочь.

Мы помогаем бизнесу решить его проблемы. Пользователь – просто часть машины :(Поможем этой части работать эффективно.

Вся надежда на интерфейс … хотя Enterprise Mobile никто не отменял …

Для каждой задачи – не просто типовое, а оптимальное типовое решение.

WebЕсли полезли инструкцию читать, значит возникли серьезные проблемы.

Mobile

Помогите пользователю не бояться вашего продукта

Что это?

Что мне с ним делать,

Человек боится всего неизвестного, и этот страх мешает пользоваться неизвестными предметами и программами.

Документация, отвечающая на эти вопросы, помогает пользователям перестать опасаться незнакомого продукта и начать с ним эффективно работать.

Как с этим бороться?

Пусть ваш документ будет понятным. Говорите с человеком на понятном ему языке. Литературный русский поймут скорее, чем сленг с аббревиатурами.

Документы любят хорошую подготовку

Замысел документа

План

Для кого будет документ, о чем мы хотим рассказать?

Общая структура, в которую при необходимости войдут новые разделы.

При аккуратном подходе к делу получаются аккуратные и удобные в использовании документы.

План-проспектПлан, раскрывающий содержимое разделов.

Многое осталось за кадром

• Внутренние стандарты компании и ГОСТ (стандарт – это совсем не страшно, если уметь ими пользоваться);

• Какие документы стоит разрабатывать?• Кто участвует в создании документа?• Какими инструментами пользуется технический писатель?• Каким должен быть язык пользовательской документации?• Как готовить иллюстрации?

• и многое другое

Изображения

Источники изображений, в порядке появления:

http://www.publishingtechnology.com/2010/11/user-behaviour-e-journal-sites/

http://www.highestfive.com/money/6-habits-bosses-love/

http://tucson.jobing.com/blog_author.asp?author=38738

http://aonetwork.com/tag/internet/

http://www.powercig.net/pourquoi.php

http://www.timeanddate.com/holidays/world/international-programmers-day

http://ecssba.rutgers.edu/docs/documents.html

http://www.cartoonary.com/monsters-inc-wallpapers/monsters-inc-sulley-and-mike-wallpaper/

Спасибо за внимание!

UX SPb «Кодекс» Юрий Солоницын10.12.2013Санкт-Петербург