Twig 3.29 получил комментарии специально для документации
Twig 3.29 получил комментарии специально для документации -- Источник -- В Twig 3.29 появились Documentation Comments — стандартный способ описывать переменные, блоки, макросы и другие конструкции прямо внутри шаблона 🚀 Для них используется отдельный синтаксис {## ... ##}. На результат рендеринга такие комментарии не влияют, зато их могут читать IDE, статические анализаторы и генераторы документации. Например, Symfony Language Tools (LSP) уже использует эти описания в автодополнении и подсказках: рядом с переменной можно увидеть её тип, обязательность и человеческое описание. Пока фича экспериментальная, так что синтаксис ещё может измениться. Но направление суперское: раньше типы и документацию в Twig нередко приходилось прокидывать через соглашения вроде {# @var ... #} и надеяться, что IDE пойдет 😕 Теперь Twig постепенно получает штатный способ хранить такую информацию прямо в шаблоне 😎 #разбор #backend #процессы