Документация ≠ текст.
Осенью 2015 года я работал тестировщиком в 2ГИС и только начинал разбираться с Ansible. Читал наши ansible-скрипты, но ничего не понимал. Читал документацию и туториалы на docs.ansible.com, и тоже ничего не понимал. Чувствовал себя нубом.
А потом я посмотрел видео, где Джефф Гирлинг показывает простые ad-hoc команды на стеке из шести «малинок» (Raspberry Pi). И после этого смог выполнить эти же команды на своем тестовом хосте. А потом и всё остальное понял, и с удовольствием драйвил тему Ansible в команде, пока не уволился.
К чему это я. Документация — это не только текст. Есть другие способы донести до читателя технические знания: видео, схемы, гифки, выступление на конференции, подкаст. Они могут работать гораздо лучше, чем текст.
Вот то самое видео: https://youtu.be/ZNB1at8mJWY
Осенью 2015 года я работал тестировщиком в 2ГИС и только начинал разбираться с Ansible. Читал наши ansible-скрипты, но ничего не понимал. Читал документацию и туториалы на docs.ansible.com, и тоже ничего не понимал. Чувствовал себя нубом.
А потом я посмотрел видео, где Джефф Гирлинг показывает простые ad-hoc команды на стеке из шести «малинок» (Raspberry Pi). И после этого смог выполнить эти же команды на своем тестовом хосте. А потом и всё остальное понял, и с удовольствием драйвил тему Ansible в команде, пока не уволился.
К чему это я. Документация — это не только текст. Есть другие способы донести до читателя технические знания: видео, схемы, гифки, выступление на конференции, подкаст. Они могут работать гораздо лучше, чем текст.
Вот то самое видео: https://youtu.be/ZNB1at8mJWY