💡 Документация — это тоже код.

Если вы еще ведете ее где-то в Confluence, на стене, в голове или в стикерах — у нас для вас идея получше :)

Мы собрали гайд по подходу doc as code: что это такое, как внедрить и для чего он нужен.

📋 Читайте лонгрид по ссылке

🧑‍💻  As Code как ДНК современной инженерной культуры

Не так давно на внутреннем митапе по стандарту разработки прозвучал провокационный вопрос, который заставил задуматься многих, особенно Максима Морева, куратора инженерного производства в нашем банке:

А что за потребность всё делать %-as-code? Какая от этого польза? Зачем число коммитящих в код?

«Потому что иначе мы останемся в прошлом, где ручные процессы замедляют каждый наш шаг», — ответил Макс.

Концепция As Code — естественное продолжение эволюции разработки, где всё — от инфраструктуры до документации — становится кодом. Такой подход превращает хаос в управляемую систему.

Каждый коммит — это шаг в будущее, а код — нить в живой ткани реальности.

Основные подходы As Code:

⭕️ Infrastructure as Code (IaC)

Что это: описание инфраструктуры (серверов, сетей, БД) в виде кода (с помощью Terraform, Ansible, CloudFormation).

Зачем: чтобы инфраструктура была воспроизводимой, предсказуемой и управляемой.

Пример: вместо ручного создания серверов в облаке — код, который разворачивает их одной командой.

⭕️ Documentation as Code (Doc as Code) см. пост выше

Что это: написание документации в формате Markdown/AsciiDoc и хранение в Git.

Зачем: чтобы документация не устаревала и была частью процесса разработки.

Пример: документация API лежит в репозитории рядом с кодом и обновляется вместе с ним.

⭕️ Architecture as Code (AaC)

Что это: описание архитектуры системы в виде кода (например, с помощью DSL — Domain Specific Language).

Зачем: чтобы архитектура была понятной, проверяемой и легко изменяемой.

Пример: использование инструментов вроде Structurizr или PlantUML для описания диаграмм и зависимостей.

⭕️ Policy as Code (PaC)

Что это: описание правил и политик (безопасности или доступа) в виде кода.

Зачем: чтобы автоматизировать проверку и обеспечить соответствие требованиям.

Пример: использование Open Policy Agent (OPA) для описания политик безопасности.

➡️ Еще больше о концепции в статье Максима

🕺 22 апреля мы провели конференцию для инженеров и разработчиков GPB CONF — такое ощущение, будто это было вчера! 🤯

Вспоминаем details, как прошло мероприятие 💅

Красиво у нас не только на конфе, но и в бэкенде — узнайте, как метрики и мониторинг делают вашу работу заметной 👨‍💻

Если вы сегодня на PHDays Fest, ждём вас на стенде МГТУ им. Н. Э. Баумана на наших лекциях 💗 Стартуем в 16:00!

Ближайшие пару дней мы на PHDays Fest 🐱

Приглашаем на стенд МГТУ им. Н.Э. Баумана, где можно оценить свои силы в поиске уязвимостей на сайте, проверить знания в кибервикторине и классно понетворкаться за настолками 🥳

Расписание лекций на сегодня:
⏺ 12:00 «Постквантовая криптография. Защита данных финансовой отрасли от кибератак настоящего и ближайшего будущего» — Антон Гугля, генеральный директор QApp

⏺ 13:00 «Практики безопасной разработки» — Артемий Юрьев, начальник отдела департамента развития технологий защиты информации

⏺ 15:00 «Безопасность данных для ИИ» — Александр Соболев, главный аналитик департамента развития технологий защиты информации

⏺ 17:00 «Безопасность ИИ, OWASP AI SEC TOP 10» — Александр Крибель, исполнительный директор департамента развития технологий защиты информации

Ждем в Лужниках! Стенд МГТУ им. Н.Э. Баумана 🐱

🍰 Java сегодня 30 лет!

Тот самый язык, с которого всё начиналось: курсы, первые pet-проекты, public static void main, закомментированные строчки «на всякий случай». Задуваем виртуальные свечи и делимся фактами, которые точно заслуживают перепоста.

5 фактов о Java, которые звучат как шутка, но это чистая правда:

1️⃣ Java могла называться Oak, но победил кофе
Изначально язык назвали в честь дуба за окном, но оказалось, что Oak уже занят. Тогда один из разработчиков глянул на меню ближайшего кафе и сказал: «Будет Java». Так что в названии языка немного кофеина и немного голода.

2️⃣ Создавали для телевизоров, а в итоге покорили интернет
В 90-х Java хотели внедрить в интерактивные ТВ-приставки. Рынок не оценил. Зато мир веба и крупных систем — очень даже. Сегодня Java — это не «только телек», но и сервера, банки, крупные платформы.

3️⃣ Write once, run anywhere
Амбициозный девиз Sun Microsystems. Суть: пишешь один раз — запускаешь везде, где есть JVM. И хотя иногда это «везде» требовало пары костылей, идея кроссплатформенности была революционной и до сих пор работает.

4️⃣ Java скрывается в неожиданных местах
Minecraft? Java. Банковские бекенды? Java. Android-приложения? До Kotlin там правил Java. Даже внутри PostgreSQL можно найти Java через расширения. Этот язык как соль в блюде: незаметен, пока есть, но его отсутствие бросается в глаза сразу — всё буквально рассыпается.

5️⃣ Java летала на Марс
В NASA использовали Java для инструментов, управлявших миссиями с марсоходами. Один из них — Mission Control Technologies — отвечал за планирование и телеметрию. Если бы Opportunity мог печатать, он бы вывел на корпусе: Java inside.

⚡ Поздравляем Java и всех, кто хотя бы раз засыпал над NullPointerException.

Пусть виртуальная машина будет доброй, а компилятор — снисходительным.

Кайфуем на PHDays 😍 А вы что как где? Как дела?

Заглядывайте на стенд МГТУ им. Н.Э. Баумана, послушать лекции спикеров Газпромбанк.Тех и понетворкаться с нашими экспертами по инфобезу 🛡️