3. Код: Машина времени ⌛

Твой код живет и меняется.

Комментируй всё! Пиши комментарии не для компилятора, а для себя-дурака из будущего. Объясняй, почему выбрана именно эта задержка, а не какая.// ЗАДЕРЖКА 500ms - подобрано экспериментально,
// чтобы реле не щелкало дребезгом при старте мотора.
delay(500);

Версионирование: Если вносишь серьезное изменение — СОХРАНЯЙ КОПИЮ файла! main_v1.0.ino, main_v1.1_fixed_bug.ino. Поверь, откатиться назад иногда проще, чем исправить новый косяк.
Настройки: В самом начале кода сделай блок комментария со ссылкой на схему и версию железа./*
ПРОЕКТ: Поливатор v1
СХЕМА: Папка /docs/SCHEMATIC.png
СПИСОК ДЕТАЛЕЙ: BOM.xlsx
*/

4. Фото сборки: Картинки вместо тысячи слов 📸

Текстом сложно объяснить, какой провод пошел над каким и как завязан узел стяжкой.

Когда фоткать: Прямо в процессе! Разложил компоненты — фото. Припаял провода — фото с двух ракурсов. Общий вид внутри корпуса — обязательно.
Нюанс: Протри объектив! 😄 Фотографии пайки должны быть четкими. Покажи крупным планом сложные узлы (например, как подключен дисплей шлейфом).
Гифка или короткое видео: Если устройство делает какое-то движение (сервопривод крутится, экран моргает), сними 5-секундное видео. Это лучший способ показать, что "всё работает".


Как это выглядит на практике? Моя магическая структура папки:

📁 [2026-08-28]_Smart_Garage_Light_v2/
├── 📄 CODE.ino (Основной рабочий файл)
├── 📄 CODE_v1_backup.ino (Старая версия, если что...)
├── 📄 components_list.txt (Тот самый BOM со ссылками)
├── 🖼️ SCHEMATIC_wokwi.png (Картинка схемы)
├── 📁 photos_assembly/ (Папка с фотографиями)
│ ├── 01_components_on_table.jpg
│ ├── 02_soldering_detail.jpg
│ └── 03_finished_inside_box.jpg
└── 📝 README.md (Описание: что это, как включить, фишки)

Когда через год я открою такую папку, мне понадобится ровно 5 минут, чтобы понять суть, заказать недостающую деталь по ссылке и собрать всё заново, глядя на фото.

Да, первый раз документировать лениво. Хочется быстрее увидеть мигающий светодиод. Но поверь моему опыту: потратить 20 минут на аккуратную запись сейчас — это сэкономить 5 часов мучений и злости потом.

Заведи себе шаблон этой папки и просто копируй его для новых начинаний. Будущее скажет тебе спасибо! 😉

А как вы ведете учет своих поделок? Есть свои лайфхаки? Кидайте идеи в комментарии, обменяемся опытом! 👇✨