Diese Präsentation wurde erfolgreich gemeldet.
Wir verwenden Ihre LinkedIn Profilangaben und Informationen zu Ihren Aktivitäten, um Anzeigen zu personalisieren und Ihnen relevantere Inhalte anzuzeigen. Sie können Ihre Anzeigeneinstellungen jederzeit ändern.
Его величество
"Документ"
Игорь Ямшанов
Telesens
Автор
• аналитик, технический
писатель, менеджер проектов,
консультант, тренер ( > 8 лет)
• преподаватель технического
ВУЗ...
Содержание
18.04.2015 И.Ямшанов, Telesens 3
• для кого пишется документ;
• цель написания;
• представление информации;
• о...
Проблемы
18.04.2015 И.Ямшанов, Telesens 4
• Не хотят писать документы потому что:
• «это никому не нужно…»
• «и так все по...
Читатель
18.04.2015 И.Ямшанов, Telesens 5
• «Внешний» или «внутренний»: формализм,
средства представления, язык, …
• Наско...
Цель
18.04.2015 И.Ямшанов, Telesens 6
• Экономия времени
• Выполнение обязательств
• Повторное использование
• Использован...
Средства (1)
18.04.2015 И.Ямшанов, Telesens 7
Структурирование информации:
• структура каталогов (проект/фаза/файл)
• стру...
Средства (2)
18.04.2015 И.Ямшанов, Telesens 8
• Словарь
• Шаблоны и повторное использование
• Best practices:
• различия п...
Инструментарий (1)
18.04.2015 И.Ямшанов, Telesens 9
• Модели
• пакеты (Enterprise Architect, Visual Paradigm,
Microsoft Vi...
Инструментарий (2)
18.04.2015 И.Ямшанов, Telesens 10
• Изображения (Paint.NET, Evolus Pencil,
Balsamiq Mockups)
• Текст (M...
Последовательность
18.04.2015 И.Ямшанов, Telesens 11
• Зависит от используемой методологии:
• включить в критерий готовнос...
Что дальше?
18.04.2015 И.Ямшанов, Telesens 12
• стандарты: IEEE Std 1063-2001,
ISO/IEC FDIS 18019:2004,
ISO/IEC 26514:2008...
Вопросы
18.04.2015 И.Ямшанов, Telesens 13
Спасибо за внимание
Игорь Ямшанов
Telesens
linkedin.com/in/iyamshanov
skype: iyamshanov
18.04.2015 И.Ямшанов, Telesens 14
Nächste SlideShare
Wird geladen in …5
×

Его величество "Документ"

1.051 Aufrufe

Veröffentlicht am

Доклад Игоря Ямшанова на конференции Analyst Days-4,
17-18 апреля 2015 г., Минск
www.analystdays.com

Veröffentlicht in: Bildung
  • Als Erste(r) kommentieren

Его величество "Документ"

  1. 1. Его величество "Документ" Игорь Ямшанов Telesens
  2. 2. Автор • аналитик, технический писатель, менеджер проектов, консультант, тренер ( > 8 лет) • преподаватель технического ВУЗа ( > 15 лет) • докладчик научно- практических конференций • модератор группы по изучению стандарта BABOK 18.04.2015 И.Ямшанов, Telesens 2
  3. 3. Содержание 18.04.2015 И.Ямшанов, Telesens 3 • для кого пишется документ; • цель написания; • представление информации; • обзор инструментария; • процесс работы над документом (best practices); • что дальше?
  4. 4. Проблемы 18.04.2015 И.Ямшанов, Telesens 4 • Не хотят писать документы потому что: • «это никому не нужно…» • «и так все понятно…» • «не понятно с чего начать и какой ожидается результат…» • Результат не соответствует ожиданиям и потраченному времени • Написанный документ сложно поддерживать в актуальном состоянии
  5. 5. Читатель 18.04.2015 И.Ямшанов, Telesens 5 • «Внешний» или «внутренний»: формализм, средства представления, язык, … • Насколько «в теме»: знание бизнеса, терминологии, наличие технического бекграунда, … • Несколько категорий читателей: единый документ или отдельные
  6. 6. Цель 18.04.2015 И.Ямшанов, Telesens 6 • Экономия времени • Выполнение обязательств • Повторное использование • Использование в процессе разработки • В наказание  • Ваш вариант?
  7. 7. Средства (1) 18.04.2015 И.Ямшанов, Telesens 7 Структурирование информации: • структура каталогов (проект/фаза/файл) • структура документа (wiki) Для документа: • идентификатор XX99.AA.00.99.TT • версия/ревизия и история изменений (номер, дата изменения, кем менялось и суть изменений) • колонтитулы (идентификатор, название, автор, дата, копирайт) • содержание • ссылки
  8. 8. Средства (2) 18.04.2015 И.Ямшанов, Telesens 8 • Словарь • Шаблоны и повторное использование • Best practices: • различия представлений • правка по диагонали • ревью после таймаута • интеллектуальный copy/paste • без количества
  9. 9. Инструментарий (1) 18.04.2015 И.Ямшанов, Telesens 9 • Модели • пакеты (Enterprise Architect, Visual Paradigm, Microsoft Visio) • онлайн сервисы (Gliffy online, LucidChart; Coggle, WiseMapping) • редакторы общего назначения Чеклист для выбора: стоимость, примитивы и диаграммы, стандарты, кастомизация, валидация, генерация документов, совместная работа, интеграция
  10. 10. Инструментарий (2) 18.04.2015 И.Ямшанов, Telesens 10 • Изображения (Paint.NET, Evolus Pencil, Balsamiq Mockups) • Текст (Microsoft Office, Apache Open Office, MediaWiki) • Контроль версий (Git, Microsoft Visual SourceSafe) • Утилиты: скриншоты (Jing), …
  11. 11. Последовательность 18.04.2015 И.Ямшанов, Telesens 11 • Зависит от используемой методологии: • включить в критерий готовности • Включаем в план проекта: • выбрать подходящее время • План, структура, наполнение: • содержимое каждого раздела • форма, удобная для восприятия
  12. 12. Что дальше? 18.04.2015 И.Ямшанов, Telesens 12 • стандарты: IEEE Std 1063-2001, ISO/IEC FDIS 18019:2004, ISO/IEC 26514:2008, ГОСТ Р ИСО 9127-94, ГОСТ Р ИСО/МЭК 15910-2002 • techwriters.ru/forum/ • Липаев В.В. Документирование сложных программных средств (2005, эл. версия)
  13. 13. Вопросы 18.04.2015 И.Ямшанов, Telesens 13
  14. 14. Спасибо за внимание Игорь Ямшанов Telesens linkedin.com/in/iyamshanov skype: iyamshanov 18.04.2015 И.Ямшанов, Telesens 14

×