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

http://docfactor.ru.

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

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

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

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

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

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

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