Technical Writing и документация: API docs, guides, runbooks и knowledge base
Как писать ясные инженерные документы: audience, structure, examples, API reference, troubleshooting, docs-as-code и review
Чему вы научитесь
- Определять audience, goal, prerequisites and success criteria документа
- Различать tutorial, how-to, explanation, reference, runbook and decision record
- Писать API docs: endpoint, auth, request, response, errors, examples and versioning
- Создавать troubleshooting guides and runbooks with symptoms, checks and actions
- Настраивать docs-as-code: Markdown, review, ownership, linting and changelog
О курсе
Курс делает документацию профессиональной инженерной компетенцией. Ученик учится писать для конкретной аудитории, строить tutorials, how-to guides, conceptual docs, API reference, runbooks, troubleshooting guides, release notes and docs-as-code workflow.
22 недель · 6 ч/нед
5 разделов · 15 шагов · практика после модулей
Итоговый проект и сертификат после завершения.
12+ лет · дети и подростки. возраст зависит от уверенности в чтении, логике и самостоятельной практике
Профессиональный: 4/5
требует дисциплины, проверки и портфолио
План программиста
Сквозная траектория: Python, JavaScript, TypeScript, React, backend, SQL, тесты, Docker и портфолио.
Как устроено обучение
Методическая подача
структурные схемы, разборы примеров, контрольные вопросы и карты применения
реалистичные учебные ситуации, где теория сразу переводится в решение
понятие, пример, самостоятельное действие, обратная связь, перенос в проект
итоговая работа с критериями качества и понятным результатом для портфолио
Учебный микс
11 визуальных материалов · 100% по предмету
иллюстрации в основном соответствуют предметному языку курса
Профессиональная программа
Измеримые результаты
- Написать tutorial и API reference для учебного сервиса
- Подготовить runbook и troubleshooting guide
- Организовать docs review workflow and ownership
Входной уровень
- Базовое письмо на русском или английском
- Понимание web/API полезно
- Готовность редактировать текст
Проверка знаний
- Tutorial rewrite
- API docs task
- Runbook review
- Docs IA audit
Итоговый проект
Documentation set: overview, quickstart, API reference, troubleshooting guide, runbook, ADR and documentation style checklist.
Программа курса
5 разделов · 15 уроков- Карта пониманияОткрыто8 мин
- Что рисовать и фиксироватьОткрыто8 мин
- Ритм практики и повторенияОткрыто8 мин
- Проверка учебного маршрутаОткрыто10 мин
- От требования к тестуОткрыто14 мин
- Архитектура вместо набора синтаксиса14 мин
- Поток данных и состояниеОткрыто15 мин
- API и база данных16 мин
- Качество: тест, review, refactor, release14 мин
- Audience и цельОткрыто10 мин
- Docs IAОткрыто11 мин
- Практика: структураОткрыто13 мин
- API referenceОткрыто11 мин
- Docs-as-codeОткрыто10 мин
- Практика: API docsОткрыто14 мин
Отзывы
Пока нет отзывов.