Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Собеседуем технических писателей (Семён Факторович)

Собеседуем технических писателей (Семён Факторович)

http://docfactor.ru.

4 ноября 2016, Новосибирск

Собеседуем технических писателей (Семён Факторович, documentat.io, Новосибирск).

Видеозапись: https://www.youtube.com/watch?v=7fuz87VkOB4

Я поделюсь своими мыслями и наблюдениями касательно отбора и собеседования технических писателей: на что нужно обращать внимание в резюме и тестовых заданиях, какие профессиональные навыки являются необходимыми при приеме на работу, а какие — нет, и какую цель должно преследовать тестовое задание.

DocFactor — конференция о технической документации и ее роли в разработке ПО.

Подробнее: http://docfactor.ru

More Decks by DocFactor: конференция о технической документации

Other Decks in Education

Transcript

  1. Собеседуем технических писателей
    Несколько слов о поиске и отборе документационных специалистов
    Семён Факторович, www.documentat.io

    View Slide

  2. Программист
    Технический
    писатель
    Менеджер
    проектов
    Мой путь

    View Slide

  3. Руководитель отдела
    технической документации
    Независимый консультант
    по процессам документирования
    Преподаватель

    View Slide

  4. View Slide

  5. Большая кодовая база (>2M LOC)
    Географически разнесенные команды
    Множество компонентов (>20)
    Передача информации в основном устно

    View Slide

  6. Ускорить передачу информации
    между разработчиками
    Цель внедрения документации:

    View Slide

  7. Архитектурные документы
    Как всё устроено внутри
    и почему всё устроено именно так

    View Slide

  8. Общение
    с программистами
    Чтение кода
    Источники информации для архитектурных документов

    View Slide

  9. 1. Техническая подкованность (основные
    концепции Linux, архитектурные паттерны...)
    2. Умение читать код на С++
    3. Хороший письменный английский
    4. Умение и желание писать документацию

    View Slide

  10. 1. Техническая подкованность (основные
    концепции Linux, архитектурные паттерны...)
    2. Умение читать код на С++
    3. Хороший письменный английский
    4. Умение и желание писать документацию

    View Slide

  11. Опыт
    программирования

    View Slide

  12. Опыт
    программирования
    Хороший
    английский

    View Slide

  13. Опыт
    программирования
    Умение писать
    Хороший
    английский

    View Slide

  14. Опыт програм-
    мирования
    Умение писать
    Хороший
    английский

    View Slide

  15. Опыт програм-
    мирования
    Умение писать
    Хороший
    английский

    View Slide

  16. Опыт
    программирования
    Умение писать
    Хороший
    английский

    View Slide

  17. Опыт работы техписателем необязателен
    Тестовое задание
    на русском или на английском
    Достаточно 1 из 3 компетенций

    View Slide

  18. Опыт
    программирования
    Умение писать
    Хороший
    английский

    View Slide

  19. Опыт програм-
    мирования
    Умение писать
    Хороший
    английский

    View Slide

  20. Опыт програм-
    мирования
    Умение писать
    Хороший
    английский

    View Slide

  21. Опыт програм-
    мирования
    Умение писать
    Хороший
    английский

    View Slide

  22. Опыт програм-
    мирования
    Умение писать
    Хороший
    английский

    View Slide

  23. View Slide

  24. • Высшее образование в области IT
    • Опыт работы программистом (чаще всего, небольшой)
    • Нежелание дальнейшего роста в текущей области
    • Высокие зарплатные ожидания

    View Slide

  25. Опыт програм-
    мирования
    Умение писать
    Хороший
    английский

    View Slide

  26. Непонятно, сколько времени займет подтягивание
    английского до уровня Advanced / Proficiency.

    View Slide

  27. Опыт програм-
    мирования
    Умение писать
    Хороший
    английский

    View Slide

  28. Опыт програм-
    мирования
    Умение писать
    Хороший
    английский

    View Slide

  29. Опыт програм-
    мирования
    Умение писать
    Хороший
    английский

    View Slide

  30. Непонятно, за какое время человек
    научится писать хорошие тексты.
    И совершенно непонятно, как этому учить.

    View Slide

  31. Опыт програм-
    мирования
    Умение писать
    Хороший
    английский

    View Slide

  32. Опыт програм-
    мирования
    Умение писать
    Хороший
    английский

    View Slide

  33. Опыт програм-
    мирования
    Умение писать
    Хороший
    английский

    View Slide

  34. • Сетевые протоколы (модель OSI, Berkeley sockets...)
    • Базовые концепции ОС (процессы, потоки, работа с
    памятью...)
    • Базовые концепции Linux (динамические
    библиотеки, примитивы синхронизации, специфика
    файловых систем...)
    • Основы программирования (функции, переменные,
    условные операторы...)
    • Специфика C++ (реализация принципов ООП,
    конструкторы/деструкторы...)

    View Slide

  35. Люди с одинаково хорошими техническими и
    гуманитарными компетенциями очень редки.
    Cтоят такие люди очень дорого.
    Урок #1

    View Slide

  36. Научить гуманитария программировать проще,
    чем научить технаря писать.
    Урок #2

    View Slide

  37. ГОСТ 34

    View Slide

  38. ГОСТ 34
    5 лет опыта

    View Slide

  39. ГОСТ 34
    AuthorIT
    5 лет опыта

    View Slide

  40. ГОСТ 34
    AuthorIT
    Infosec
    5 лет опыта

    View Slide

  41. ГОСТ 34
    MS Word
    AuthorIT
    Infosec
    Confluence
    5 лет опыта

    View Slide

  42. ГОСТ 34
    MS Word
    AuthorIT
    Infosec
    С++
    Confluence
    5 лет опыта

    View Slide

  43. ГОСТ 34
    MS Word
    AuthorIT
    Infosec
    С++
    Английский уровня Advanced
    Confluence
    5 лет опыта

    View Slide

  44. ГОСТ 34
    MS Word
    AuthorIT
    Infosec
    С++
    Английский уровня Advanced
    Опыт руководства
    Confluence
    5 лет опыта

    View Slide

  45. Навыки могут быть приобретаемыми
    А могут быть врожденными
    (сложноприобретаемыми)

    View Slide

  46. • Использование документационных стандартов
    • ГОСТ 34, IEEE...
    • Использование документационных технологий
    • DITA, Markdown, rST, Confluence...
    Приобретаемые навыки

    View Slide

  47. • Владение конкретными инструментами
    • AuthorIT, MadCap Flare...
    • Опыт в конкретной предметной области
    • Infosec, JavaScript...
    Приобретаемые навыки

    View Slide

  48. • Абсолютная грамотность
    • Или, по крайней мере, низкое количество технических ошибок в
    тексте
    • Любовь к работе с текстом
    • «Да, я могу провести два часа, выискивая в своем тексте
    ненужные аллитерации и слишком заковыристые
    сложноподчиненные предложения»
    Врожденные «навыки»

    View Slide

  49. • Страсть к узнаванию новой информации
    • Умение объяснять и учить
    • Хороший документ — не хранилище неструктурированных знаний,
    а педагогический продукт
    Врожденные «навыки»

    View Slide

  50. • Умение структурировать информацию на письме
    • Владение иностранным языком на уровне,
    достаточном для написания документации
    • Путь от C1 до C2 совсем не такой, как от B1 до C1

    View Slide

  51. • Умение структурировать информацию на письме
    • Владение иностранным языком на уровне,
    достаточном для написания документации
    • Путь от C1 до C2 совсем не такой, как от B1 до C1
    Тоже приобретаемые навыки

    View Slide

  52. • Умение структурировать информацию на письме
    • Владение иностранным языком на уровне,
    достаточном для написания документации
    • Путь от Advanced до Proficiency совсем не такой, как от Intermediate
    до Advanced
    Тоже приобретаемые навыки

    View Slide

  53. Ищите людей с врожденными навыками
    и доучивайте их на месте

    View Slide

  54. • Грамотность
    • Любовь к тексту
    • Страсть к поглощению новой информации
    • Стремление научить текстом
    Разыскиваются

    View Slide

  55. • Опыт работы по специальности
    • Тексты как хобби
    • Блоги, переводы, документирование opensource-проектов
    Что в резюме тебе моем?

    View Slide

  56. Тестовое задание

    View Slide

  57. Расскажите владельцу интернет-магазина,
    чем HTTP отличается от HTTPS

    View Slide

  58. Расскажите разработчику, что такое Unicode
    и чем UTF-8 отличается от UTF-16

    View Slide

  59. О чем можно говорить на
    собеседовании после
    плохого тестового задания?

    View Slide

  60. О чем можно говорить на
    собеседовании после
    хорошего тестового задания?

    View Slide

  61. • Не нужно хотеть от кандидатов всего и сразу
    • Разделяйте приобретаемые и врожденные навыки
    • Ищите тех, кто любит текст
    • Проверяйте эту любовь тестовым заданием
    Подытожим

    View Slide

  62. Спасибо!
    Семён Факторович, www.documentat.io

    View Slide