Стандарт проведения техтолков
Техтолк — это инструмент развития инженерной культуры компании. Он помогает делиться практическим опытом, обсуждать реальные технические решения и повышать общий уровень экспертизы команды.
Хороший техтолк строится вокруг одной чёткой мысли, раскрытой через практику. Он не повторяет документацию и не перегружает слушателей теорией. Вместо этого он:
- показывает проблему,
- описывает контекст и ограничения,
- объясняет принятое решение,
- демонстрирует реализацию,
- формулирует выводы и рекомендации.
Если после доклада слушатель понимает, что именно он может сделать по‑другому завтра, цель достигнута.
Отдельную категорию составляют обучающие техтолки (например: архитектурные подходы, принципы проектирования, паттерны, такие как Clean Architecture, DDD, CQRS и т.д.).
Даже если тема носит теоретический характер, доклад должен быть привязан к практике компании. Рекомендуется:
- показать, какую конкретную проблему решает подход;
- разобрать типичные ошибки или анти‑паттерны;
- привести пример из существующих проектов;
- сравнить альтернативные решения и объяснить выбор;
- сформулировать рекомендации по применению в наших условиях.
Формат техтолка остаётся компактным.
| Параметр | Требование |
|---|---|
| Минимальная длительность | 15 минут |
| Рекомендуемый формат | 25–40 минут + вопросы |
| Допустимое отклонение | не более 5 минут |
Регламент существует для уважения времени участников и поддержания качества встреч.
Логика выступления должна быть последовательной. Рекомендуемая модель построения:
Проблема → Контекст и ограничения → Решение → Демонстрация → Выводы
Такая структура помогает аудитории понимать не только что было сделано, но и почему выбран именно этот подход.
Допускаются альтернативные структуры, если они обоснованы и сохраняют логическую целостность материала.
Каждый техтолк проходит минимум одно предварительное ревью. Его задача — проверить:
- корректность технического содержания;
- логичность структуры;
- понятность формулировок;
- соответствие теме и заявленным тезисам;
- соблюдение регламента по времени.
Ревью проводит технический эксперт или тимлид с релевантной экспертизой. При необходимости рекомендуется провести пробный прогон доклада.
Анонс публикуется не позднее чем за три рабочих дня до выступления. Он должен содержать:
- тему;
- имя спикера;
- краткое описание.
Дополнительно размещаются тезисы (3–7 пунктов), отражающие ключевые идеи. Это формирует корректные ожидания и помогает подготовить вопросы заранее.
После проведения техтолка спикер размещает материалы в корпоративной базе знаний. Публикация включает:
- презентацию;
- запись (при наличии);
- примеры кода;
- дополнительные ссылки.
Доклад считается полностью завершённым только после публикации материалов.
Перед выступлением спикер подтверждает готовность по следующему чек‑листу:
- тема согласована;
- анонс опубликован;
- тезисы подготовлены;
- ревью проведено;
- презентация финализирована;
- демонстрации и код проверены;
- тайминг протестирован;
- материалы готовы к публикации.
Ответственность за качество доклада полностью лежит на спикере.
Настоящий стандарт применяется ко всем внутренним техническим докладам компании и может пересматриваться по мере развития инженерных практик.