Docs as Code: Пишем тексты как код — курс от Stepik
«Docs as Code» на Stepik — курс для технических писателей и системных аналитиков. 12 уроков по подходу Docs as Code: разметка AsciiDoc для структурированной документации, диаграммы PlantUML для визуализации архитектуры, версионирование через Git/GitHub, автоматическая сборка и публикация в HTML через Asciidoctor. Практический кейс — полная документация HTTP-сервиса от структуры до публикации.
Как мы оцениваем курсы
Рейтинг ToolFox формируется по 5 критериям, каждый оценивается от 1 до 10:
- Качество программы — полнота материала, актуальность технологий
- Практика — реальные проекты, код-ревью, тренажёры
- Поддержка — наставники, обратная связь, сообщество
- Трудоустройство — карьерный центр, помощь с резюме
- Цена/качество — соотношение стоимости и получаемых навыков
Итоговый балл — среднее арифметическое 5 критериев. Обновляется при каждом пересмотре курса.
- Платформа
- Stepik
- Автор
- Алексей Лобзов, Stepik
- Длительность
- 1 мес, 3 ч/нед
- Формат
- Онлайн, самостоятельный темп
- Уровень
- Средний
- Язык
- Русский
- Сертификат
- Сертификат Stepik
- Обновлено
- март 2026 г.
Полная стоимость: 4 500 ₽
Программа и содержание
Модули и темы
Знакомство с подходом Docs as Code и его преимуществами для технических писателей. Обзор инструментов. Настройка рабочего окружения через консоль с vim.
- Docs as Code
- Инструменты
- vim
- Окружение
Введение в Docs as Code
Подход, инструменты, настройка окружения
Знакомство с подходом Docs as Code и его преимуществами для технических писателей. Обзор инструментов. Настройка рабочего окружения через консоль с vim.
- Docs as Code
- Инструменты
- vim
- Окружение
AsciiDoc и PlantUML
Разметка для документации и диаграммы
Основы AsciiDoc для создания исходных файлов документации: заголовки, таблицы, ссылки. PlantUML для диаграмм: визуализация архитектуры и процессов HTTP-сервиса.
- AsciiDoc
- Структура
- PlantUML
- Диаграммы
Git и публикация
Версионирование и автоматическая сборка
Версионирование документации через Git: теги, клонирование, командная работа. Локальная компиляция в HTML через Asciidoctor. Автоматическая сборка и публикация при push.
- Git
- GitHub
- Asciidoctor
- Автосборка
Чему научитесь
Для кого подходит
- →Технические писатели
- →Системные аналитики
- →Разработчики, пишущие документацию
Требования
- →Базовое понимание IT-процессов
Плюсы и минусы курса Docs as Code: Пишем тексты как код
Обзор подготовлен редакцией ToolFox · Обновлено: март 2026 г.
Плюсы
- Уникальная тематика — единственный русскоязычный курс по Docs as Code
- Практика через консоль формирует глубокое понимание
- Реальный кейс с HTTP-сервисом
- Доступная цена — 4 500 ₽
Минусы
- Консоль и vim сложны для новичков
- Узкая специализация — только для IT
- Небольшой объём — 12 уроков
Отзывы (1)
Загрузка комментариев...
Часто задаваемые вопросы
Что такое Docs as Code?
Нужно ли программировать?
Какое ПО нужно?
На каком кейсе обучение?
Можно ли в своём темпе?
Что такое Docs as Code?
Методология, при которой документация создаётся как код: текстовые файлы, версионирование через Git, автоматическая сборка и публикация.
Нужно ли программировать?
Нет. Достаточно базового понимания IT. Работа с консолью и инструментами даётся в курсе.
Какое ПО нужно?
vim (или аналог), Git, Asciidoctor. После освоения через консоль можно перейти на IDE.
На каком кейсе обучение?
Практический кейс — техническая документация HTTP-сервиса от структуры до публикации.
Можно ли в своём темпе?
Да. Самостоятельное прохождение без дедлайнов.