😒 Документация — вечная боль программиста

Кто-то пишет её в Word, кто-то забивает и хранит всё в голове. Но есть и третий путь — прямо в редакторе.

В VSCode есть плагины, которые реально меняют подход к документации:

Jupyter — как личный Python-блокнот с GitHub-интеграцией.

Draw.io Integration — диаграммы внутри VSCode, без лишнего софта.

Markdown All in One — Markdown с живым превью рядом.

Quarto — экспортируешь документацию в HTML, PDF или даже ePub прямо из редактора.

Mermaid — за пару кликов визуализируешь структуру кода диаграммами.

💭 А вы ведёте документацию в проектах?

🙏 — да, и плагины — мастхэв
😁 — нет, живу по принципу «и так понятно»
🌚 — хочу начать, но не знаю с чего

🐸Proglib Academy

#буст

Другими словами, чем больше экран — тем меньше твоя «значимость» в компании.

💭 Что думаете?

👾 — я на стороне «многомониторных», кайфую от продуктивности

😁 — хочу расти в сторону управления и меньше упираться в экран

🐸Proglib Academy

#междусобойчик

🧩 Как сгенерировать нужный кусок кода за секунды: промпт для ChatGPT

Мелкие, но регулярные задачи вроде хуков, адаптивных блоков или забытого fetch с таймаутом съедают часы. Вместо бесконечного гуглинга — спроси у ИИ.

Один из наиболее практичных промптов из блога Requestly помогает именно с этим:

🔴 PROMPT:

Generate a code snippet for [specific task]

Например:

“Generate a code snippet for a custom React hook that syncs state with localStorage”

Чем полезен этот промпт:

1️⃣ Код появляется за пару секунд — без лишнего гуглинга.

2️⃣ ChatGPT объясняет, как и почему всё работает.

3️⃣ Подходит под любой стек — от React до Tailwind.

🐸Proglib Academy

#буст

Что выведет код?

😁 — False False
👍 — False True
❤️ — True False
❤️‍🔥 — True True

🐸Proglib Academy

#междусобойчик

Сеньор просто закрывает глаза на мелочи — и это тоже опыт.

Что думаете?

👾 — сеньор всегда прав, даже когда ленится
🤔 — лучше давать на ревью маленькими кусками
💯 — в больших простынях баги просто растворяются

🐸Proglib Academy

#развлекалово

🎓 Бесплатный курс по фундаментальным моделям от Университета Ватерлоо — с 1 сентября самое время начать учебу!

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

🔘Рекуррентные и свёрточные нейронные сети (RNN и CNN).
🔘Обработка естественного языка (NLP) и компьютерное зрение (CV).
🔘Механизм внимания и трансформеры.
🔘Предобучение языковых моделей.
🔘Обучение с подкреплением через обратную связь (RLHF).
🔘Построение мультимодальных моделей.
🔘Диффузионные модели и генерация изображений.

🔗 Ссылка на материалы курса

🐸Proglib Academy

#буст

Когда очень хочется поиграть, но сегодня 1ое сентября

🐸Proglib Academy

#развлекалово

📌 Хранилище с 6000+ готовыми UI-компонентами на HTML/CSS.

Забираем пока все бесплатно

📎 Ссылка

Ставь 💖, если понравился ресурс

🐸Proglib Academy

#буст

🍴 «В корпорации вы будете много кодить и быстро прокачаетесь»

На деле всё чаще выходит наоборот.

5–6 часов уходит на созвоны, ожидание доступов, согласования и переписку.
А на реальный кодинг остаётся часа два — и то в лучшем случае.

И это не то чтобы плохо — просто другая реальность. В корпе учишься не только писать код, но и жить в процессах.

💬А у вас тоже кодинг — это бонус после 6 часов созвонов?

🐸Proglib Academy

#междусобойчик

🌸 Чек-лист для тестирования API

В нем собраны ключевые сценарии, покрывающие корректность обработки данных, валидацию, статус-коды, работу с различными HTTP-методами и особенности бизнес-логики.

1️⃣ Корректность структуры данных

• Сопоставляем структуру данных с API-спецификацией

• Валидируем обязательные и необязательные поля

• Сверяем типы данных с ожидаемыми

2️⃣ Тестирование POST-запросов

• Отправляем запрос с полным набором валидных данных и отслеживаем корректный результат

• Отправляем минимально необходимый набор данных для успешного создания

• Имитируем отправку без обязательных полей и получаем соответствующую ошибку

• Подаём запрос без тела и фиксируем корректную обработку ошибки

• Подставляем как корректные, так и ошибочные данные для проверки валидации

• Отправляем пустой JSON и анализируем ответ

• Проверяем автозаполнение даты создания объекта

3️⃣ Тестирование GET-запросов

• Запрашиваем список при отсутствии данных и получаем пустой результат

• Получаем список с данными и сверяем корректность

• Прогоняем пагинацию с limit и offset, включая пограничные значения

• Передаём некорректные параметры и анализируем ошибки 400

• Выполняем запрос по валидному ID и убеждаемся в правильности возвращаемых данных

• Подаём несуществующий ID и ожидаем 404

• Используем невалидный формат ID и получаем ошибку 400.

4️⃣ Тестирование PUT-запросов

• Обновляем объект с валидными данными и отслеживаем результат

• Имитируем обновление несуществующего объекта и получаем 404

• Отправляем некорректный ID и получаем 400

• Проверяем валидацию при обновлении с ошибочными значениями

• Обновляем частично — передаём только нужные поля и убеждаемся в корректной обработке

5️⃣ Тестирование DELETE-запросов

• Удаляем существующий объект и получаем подтверждение

• Повторно удаляем уже удалённый объект и фиксируем ошибку

• Пытаемся удалить несуществующий объект и получаем 404

• Отправляем невалидный ID и убеждаемся в корректной ошибке

• Удаляем объект и заново создаём его с теми же уникальными полями — исключаем конфликт

6️⃣ Проверка статусов ответов

• Отслеживаем корректность возвращаемых статусов (200, 201, 204, 400, 401, 403, 404, 500 и т.д.) в зависимости от сценария

7️⃣ Проверка всех возможных ошибок

• Симулируем сетевые сбои, таймауты и передаём некорректные данные — отслеживаем поведение API

8️⃣ Специфичные проверки для сложной логики

• Проверяем работу сложных сценариев, зависимостей и бизнес-правил (например, нельзя удалить связанную сущность)

9️⃣ Тестирование безопасности

• Проверяем доступ к защищённым ресурсам только при наличии валидной авторизации

• Отправляем запросы с просроченными, отсутствующими и поддельными токенами — анализируем реакции API

Сохраняй себе, пригодится 📎

🐸Proglib Academy

#буст