Documentat.io

Git для технических писателей: продвинутый курс

О чём этот курс?

В психологии навыков есть понятие OK Plateau («плато достаточности») — уровень, на котором вы используете только базовые возможности инструмента, достаточные для решения рутинных задач, и поэтому перестаёте расти.

Git — инструмент настолько многогранный и неочевидный, что это плато обходится техническому писателю слишком дорого. Без понимания внутренней механики мы годами пользуемся тремя заученными командами, боимся сделать шаг в сторону, каждый раз изобретаем костыли и впадаем в ступор при любом сообщении об ошибке. Кажущийся парадокс: можно несколько лет работать с Git на одном проекте и заново учиться при переходе на другой.

Цель курса — за восемь часов вывести вас далеко за пределы OK Plateau. Мы достроим целостную ментальную модель Git, уберём страх «нажать не туда» и научимся использовать продвинутые возможности для работы с документацией.

Для кого этот курс?

• Для технических писателей, которые освоили базу (add, commit, push), но хотят уверенно решать сложные задачи.
• Для руководителей команд документирования, которые хотят выстроить в команде грамотные процессы работы с Git.

Программа курса

• Механика веток, или зачем нужен git fetch. Разберёмся, как в точности устроены указатели.

• Stash — ваше хранилище изменений. Научимся прятать черновики и накатывать их поверх другого коммита.

• Merge, rebase, ручное накатывание изменений. Сравним стратегии объединения веток и переноса изменений.

• Мастерство diff. Настроим сравнение текстов по словам и таблиц по ячейкам.

• Сложные конфликты слияния. Научимся распутывать противоречия в больших документах и запоминать решения.

• Как откатить и вернуть всё потерянное. Освоим три режима reset и спасительную команду reflog.

• Места, где лежат настройки Git, и как в них не запутаться. Наведём порядок в уровнях конфигурации и правилах репозитория.

• Поддержка нескольких версий документации с помощью cherry-pick. Отработаем точечный перенос правок между ветками.

• Опасные операции в Git. Разберём правила работы с push --force.

• Важнейшие расширения VS Code. Подключим плагины, ускоряющие ежедневную работу и избавляющие от рутины.

• Бонус: обсудим функции, используемые редко, но метко.

Формат курса

Курс проводится в формате живых вебинаров с практическими заданиями. Видеозаписи занятий будут доступны участникам в течение неограниченного времени.

Для участия потребуются Zoom, Telegram, Git и VS Code. Список других инструментов будет опубликован заранее.