Мы используем файлы cookie для обеспечения работоспособности сервиса, улучшения навигации и маркетинговых активностей Yolonce. Нажимая "Согласен", вы соглашаетесь с нашей Политикой конфиденциальности

Docs as Code: Пишем тексты как код

  Сложность

Повышение квалификации

  Длительность

Пока неизвестно

  Формат

онлайн

  Документ по выпуску

Сертификат Stepik

Стоимость курса
4 500

Подробнее о курсе

Цель курса состоит в знакомстве с подходом Docs as Code при написании текстов. Курс построен на базе кейса, в ходе которого учащийся напишет техническую документацию на HTTP-сервис. Результат может быть использован в качестве проекта в вашем портфолио. Особенность курса состоит в создании структуры технической документации и написании файлов с исходниками текстов из кейса через консоль с помощью редактора vim или аналогов. Это необходимо для лучшего понимания используемых технологий. Только после завершения этого этапа рекомендуется переходить к использованию специализированных IDE (например, IntelliJ IDEA), позволяющих значительно ускорить процесс работы над текстами. В курсе будут использованы технологии:

Документ после выпуска

Сертификат Stepik

Автор курса

Stepik — образовательная платформа и конструктор онлайн-курсов. Мы разрабатываем алгоритмы адаптивного обучения, сотрудничаем с авторами MOOC, помогаем в проведении олимпиад и программ переподготовки. Наша цель — сделать образование открытым и удобным. Stepik — широко известная российская образовательная платформа, основанная в 2013 году. На Stepik зарегистрировано более миллиона пользователей из России и стран СНГ. В настоящее время на Stepik представлены несколько тысяч учебных курсов на самые разные темы.

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

  Учимся писать техническую документацию


- Введение
- Основы языка текстовой разметки Asciidoc
- Основы разработки диаграмм с использованием PlantUml

  Учимся работать с версиями технической документации


- Схемы версионирования
- Основы контроля версий c использованием git
- Знакомство с тегами в git

  Учимся совместной работе над технической документацией


- Клонирование удалённого репозитория и внесение изменений
- Проверка изменений и сохранение на удалённом сервере
- Отправка технической документации на сервер

  Учимся автоматизировать сборку и публиковать в сети интернет


- Сборка и публикация при отправке (push) изменений в main
- Сборка и публикация при сохранении (merge) изменений в main
- Заключение

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

Технические писатели, системные аналитики, разработчики. Все, кто пишет тексты и связан с ИТ

Что вы получите

пользоваться языком текстовой разметки Asciidoc и PlantUml для создания исходников технической документации;

собирать техническую документацию локально в формате html;

настраивать автоматическую сборку и размещение технической документации в сети интернет

Познакомимся с подходом Docs as Code, предлагающим использование инструментов разработчика для написания текстов различной природы от технической документации на приложения, сервисы, цифровые продукты до статей, учебных курсов, блог-постов

Оставьте отзыв

Напишите ваш коментарий, не менее 30 символов

Нажимая кнопку, вы даете согласие на обработку персональных данных

обновлено: 19.09.2024

Оставьте заявку

Наши консультанты ответят на все вопросы
И помогут в выборе

Комментарий ...

Нажимая кнопку, вы даете согласие на обработку персональных данных