Поговорим о документации?

Ждём вас на августовском потоке курса «Документация API»! 📅 Когда: 8–16 августа по субботам и воскресеньям с 11:00 до 14:00 по МСК 📍 Где: онлайн, записи лекций будут доступны участникам Этот курс посвящен API-документации, а также инструментам и процессам, которые с ней связаны. Он пригодится техническим писателям, которые уже успели попробовать себя в разработке различных видов документации, но пока не знакомы с концепцией API — приходите, чтобы разобраться в том, что такое REST API и OpenAPI, и вместе с нами разложить всё по полочкам! На курсе вас ждет не только обширная теория, но и много практики — вы оцените качество чужой API-документации и напишете собственный справочник API, попробуете поработать с «живым» API и направить запросы к нему, сможете самостоятельно сгенерировать и опубликовать в сети API-документацию. В программе: ▪️ Введение в API.​ Виды API-документации. ▪️ REST API: особенности, форматы данных. ▪️ Справочники API: спецификация OpenAPI. ▪️ Инструменты для разработки API-документации. ▪️ Публикация API-документации. Курс проводится в формате вебинаров с практическими заданиями. Преподаватель курса — Денис Мазин. Стоимость участия — 40 000 рублей. Доступна оплата в рассрочку через сервис «Долями». 📝 Подробнее узнать о программе курса и оставить заявку: documentat.io/courses/api-documentation

Приглашаем на первый поток курса «Документируй как инженер: практический курс Docs as Code» 📅 Когда: с 31 августа по 4 сентября с 16:00 до 20:00 по МСК 📍 Где: онлайн, записи лекций будут доступны участникам Docs as Code используют везде: от корпораций и опенсорсных проектов мирового уровня до гаражных стартапов. Крупным командам эта технология позволяет держать под контролем масштабные документационные проекты, небольшим — сделать документирование посильной задачей. Число вакансий, в которых требуется владение Docs as Code, растёт год от года. Курс поможет слушателям освоить Docs as Code на практике: разобраться в процессах и основном инструментарии, научиться работать в команде и автоматизировать рутину. После завершения курса вы сможете полноценно участвовать в проектах, где уже используют Docs as Code, или внедрить этот подход в своей организации. В программе курса: ▪️ Философия и архитектура Docs as Code. ▪️ Текстовые редакторы, среда разработки, синтаксис разметки. ▪️ Системы сборки и генераторы статических сайтов, сравнительный обзор популярных конвертеров, архитектура конфигурации проекта. ▪️ Структура технического репозитория и архитектурный анализ масштабных проектов на примере Yandex Cloud, GitLab, Kubernetes, VS Code и Ubuntu. GitHub и GitLab для технического писателя. ▪️ Жизненный цикл изменений и контроль версий. ▪️ Публикация изменений и рецензирование. ▪️ Карьерный трек и валидация опыта. Курс состоит из тематических модулей, каждый из которых связан с практической задачей: написать страницу, найти нужный материал в проекте, исправить ошибку, собрать сайт, проверить документацию, сохранить изменение в Git и отправить его на проверку. Преподаватель курса — Василий Лукьянов. Стоимость участия — 40 000 рублей. Доступна оплата в рассрочку через сервис «Долями». 📝 Подробнее узнать о программе курса и оставить заявку: documentat.io/courses/docs-as-code

чёрт прости, я так люблю твои словечки, что уже интернализировала их))

Если приходят спамеры, тегайте, пожалуйста, @rinageorgieva

Эта команда доступна только в личном чате с ботом.

Не можешь предотвратить - возглавь

Да, идея понятна. Благодарю за пояснения. Предположу, что контролировать ситуацию и делать все самостоятельно - это не одно и то же. Когда по кайфу - тогда да. А когда нет и можно это делегировать тем же девопсам, но при этом все равно быть владельцем процесса - мне кажется, это тоже ОК-норм.

тут скорее вопрос в том чтобы показывать реальные метрики до и после, а не верить на слово вендорам. я видел как разбирали подход когда сначала пилот на маленьком процессе запускают и замеряют время, а уже потом раскатывают. ну и аргумент про "а давайте просто попробуем" обычно не канает перед топом , нужны цифры. в @polzastas был кейс где как раз про это писали, как продавать ии-внедрение руководителям чтобы не отказали

Спасибо за ответ! 🤘

О, прости, Саш, тетку неразумную, я работала в этот момент🙈 и увы, не смотрела❤️