Где в коде: docs/_extra/llms.txt:1-50, docs/index.rst (toctree)
Проблема
llms.txt перечисляет страницы документации для LLM, но в нём нет страниц, которые есть в toctree файла index.rst:
pages/event-handling/handlers есть, а pages/event-handling/flags - нет;
- нет
pages/utils/link, pages/utils/callback_answer, pages/utils/chat_action (весь раздел «Утилиты»);
- нет
pages/changelog;
- в разделе «API Reference» перечислены только
index, omitted и text_formatting, а types, methods, enums, updates пропущены.
Предлагаемое решение
Генерировать llms.txt из toctree в docs/conf.py (аналогично тому, как уже генерируется changelog) либо добавить тест, сверяющий списки.
Почему это важно
Файл существует специально, чтобы LLM-ассистенты (и Context7/DeepWiki, на которые ведут бейджи README) видели полную карту доков. Неполный llms.txt даёт ассистентам неполный ответ.
Где в коде:
docs/_extra/llms.txt:1-50,docs/index.rst(toctree)Проблема
llms.txtперечисляет страницы документации для LLM, но в нём нет страниц, которые есть вtoctreeфайлаindex.rst:pages/event-handling/handlersесть, аpages/event-handling/flags- нет;pages/utils/link,pages/utils/callback_answer,pages/utils/chat_action(весь раздел «Утилиты»);pages/changelog;index,omittedиtext_formatting, аtypes,methods,enums,updatesпропущены.Предлагаемое решение
Генерировать
llms.txtизtoctreeвdocs/conf.py(аналогично тому, как уже генерируется changelog) либо добавить тест, сверяющий списки.Почему это важно
Файл существует специально, чтобы LLM-ассистенты (и Context7/DeepWiki, на которые ведут бейджи README) видели полную карту доков. Неполный
llms.txtдаёт ассистентам неполный ответ.