Files

T

“Naeel” c9a881aa84 feat(P1): новый LLM-промпт для документации — правила A-E

- value_list → читаемый текст (Допустимые значения)
- regex → описание формата
- пустые описания → заполнять из MAN
- группы map-fixed → 1 предложение о содержимом
- операции без описания → шаблоны
- MAN-контекст для params/ops файлов
- max_tokens 4096 → 8192
- вывод в docs_llm/ вместо перезаписи docs/

2026-08-09 21:11:03 +04:00

1.6 KiB

Raw Blame History

Sonnet: финальный план P1 — 05_generate_docs_llm.py

Пайплайн на один сервис

docs/Name.md               ─┐
docs/Name_params_create.md  ─┤  LLM  →  docs_llm/Name.md
docs/Name_params_modify.md  ─┤          docs_llm/Name_params_create.md
docs/Name_ops.md            ─┤          docs_llm/Name_params_modify.md
docs/Name_example.md        ─┘          docs_llm/Name_ops.md
                                        docs_llm/Name_example.md

docs/Name_outputs.md        ─── copy →  docs_llm/Name_outputs.md
docs/Name_params.md         ─── copy →  docs_llm/Name_params.md
docs/Name_subresource*.md   ─── copy →  docs_llm/Name_subresource*.md

Ключевые детали

MAN-контекст

Извлекается из docs/Name.md (raw HTML) функцией extract_man()
Передаётся в том же сообщении что и params/ops файлы
Для главной страницы (Name.md) и примеров (_example.md) — без MAN

Параметры LLM

max_tokens: 4096 → 8192
temperature: 0.15 (без изменений)
model: gpt-oss-120b (без изменений)

Интеграция с 04_build_and_publish_docs.sh

Вариант A: DOCS_GEN_DIR → docs_llm/. Скрипт копирует guides/, 30_registry/, index.md в docs_llm/.

Вопрос: subresource-страницы обрабатывать LLM?

postgres_user.md, postgres_database.md, postgres_backup.md — их структура как у _params_create.md. Пока копировать as-is или тоже через LLM?

1.6 KiB Raw Blame History Unescape Escape