# Стандарт проведения техтолков

Техтолк — это инструмент развития инженерной культуры компании. Он помогает делиться практическим опытом, обсуждать реальные технические решения и повышать общий уровень экспертизы команды.

---

Хороший техтолк строится вокруг одной чёткой мысли, раскрытой через практику. Он не повторяет документацию и не перегружает слушателей теорией. Вместо этого он:

* показывает проблему,
* описывает контекст и ограничения,
* объясняет принятое решение,
* демонстрирует реализацию,
* формулирует выводы и рекомендации.

Если после доклада слушатель понимает, *что именно он может сделать по‑другому завтра*, цель достигнута.

---

Отдельную категорию составляют обучающие техтолки (например: архитектурные подходы, принципы проектирования, паттерны, такие как Clean Architecture, DDD, CQRS и т.д.).

Даже если тема носит теоретический характер, доклад должен быть привязан к практике компании. Рекомендуется:

- показать, какую конкретную проблему решает подход;
- разобрать типичные ошибки или анти‑паттерны;
- привести пример из существующих проектов;
- сравнить альтернативные решения и объяснить выбор;
- сформулировать рекомендации по применению в наших условиях.

---

Формат техтолка остаётся компактным.

| Параметр                 | Требование            |
| ------------------------ | --------------------- |
| Минимальная длительность | 15 минут              |
| Рекомендуемый формат     | 25–40 минут + вопросы |
| Допустимое отклонение    | не более 5 минут      |

Регламент существует для уважения времени участников и поддержания качества встреч.

---

Логика выступления должна быть последовательной. Рекомендуемая модель построения:

> Проблема → Контекст и ограничения → Решение → Демонстрация → Выводы

Такая структура помогает аудитории понимать не только *что* было сделано, но и *почему* выбран именно этот подход.

Допускаются альтернативные структуры, если они обоснованы и сохраняют логическую целостность материала.

---

Каждый техтолк проходит минимум одно предварительное ревью. Его задача — проверить:

* корректность технического содержания;
* логичность структуры;
* понятность формулировок;
* соответствие теме и заявленным тезисам;
* соблюдение регламента по времени.

Ревью проводит технический эксперт или тимлид с релевантной экспертизой. При необходимости рекомендуется провести пробный прогон доклада.

---

Анонс публикуется не позднее чем за три рабочих дня до выступления. Он должен содержать:

* тему;
* имя спикера;
* краткое описание.

Дополнительно размещаются тезисы (3–7 пунктов), отражающие ключевые идеи. Это формирует корректные ожидания и помогает подготовить вопросы заранее.

---

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

* презентацию;
* запись (при наличии);
* примеры кода;
* дополнительные ссылки.

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

---

Перед выступлением спикер подтверждает готовность по следующему чек‑листу:

* тема согласована;
* анонс опубликован;
* тезисы подготовлены;
* ревью проведено;
* презентация финализирована;
* демонстрации и код проверены;
* тайминг протестирован;
* материалы готовы к публикации.

Ответственность за качество доклада полностью лежит на спикере.

---

Настоящий стандарт применяется ко всем внутренним техническим докладам компании и может пересматриваться по мере развития инженерных практик.