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

Transcript

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

    специалистов Семён Факторович, www.documentat.io
  2. Программист Технический писатель Менеджер проектов Мой путь

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

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

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

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

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

  9. 1. Техническая подкованность (основные концепции Linux, архитектурные паттерны...) 2. Умение

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

    читать код на С++ 3. Хороший письменный английский 4. Умение и желание писать документацию
  11. Опыт программирования

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

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

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

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

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

  17. Опыт работы техписателем необязателен Тестовое задание на русском или на

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

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

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

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

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

  23. None
  24. • Высшее образование в области IT • Опыт работы программистом

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

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

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

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

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

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

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

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

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

  34. • Сетевые протоколы (модель OSI, Berkeley sockets...) • Базовые концепции

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

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

  37. ГОСТ 34

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

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

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

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

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

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

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

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

  46. • Использование документационных стандартов • ГОСТ 34, IEEE... • Использование

    документационных технологий • DITA, Markdown, rST, Confluence... Приобретаемые навыки
  47. • Владение конкретными инструментами • AuthorIT, MadCap Flare... • Опыт

    в конкретной предметной области • Infosec, JavaScript... Приобретаемые навыки
  48. • Абсолютная грамотность • Или, по крайней мере, низкое количество

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

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

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

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

    на уровне, достаточном для написания документации • Путь от Advanced до Proficiency совсем не такой, как от Intermediate до Advanced Тоже приобретаемые навыки
  53. Ищите людей с врожденными навыками и доучивайте их на месте

  54. • Грамотность • Любовь к тексту • Страсть к поглощению

    новой информации • Стремление научить текстом Разыскиваются
  55. • Опыт работы по специальности • Тексты как хобби •

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

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

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

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

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

  61. • Не нужно хотеть от кандидатов всего и сразу •

    Разделяйте приобретаемые и врожденные навыки • Ищите тех, кто любит текст • Проверяйте эту любовь тестовым заданием Подытожим
  62. Спасибо! Семён Факторович, www.documentat.io