---
title: "Обновлён документ «Принципы создания документации»"
description: "Опубликована новая версия документа с акцентом на структуру, логику и формат для LLM и людей."
date: 2025-02-12
display_date: "12 февраля 2025"
image: "/img/brand/doc.svg"
image_alt: "Обновлены принципы документации"
---

# Обновлён документ «Принципы создания документации»

<zoom-img
            src="/img/brand/doc.svg"
            alt="Принципы создания документации"
            width="100px"
            style="float: left; margin: 15px 15px 0 0;"
    ></zoom-img>

Опубликована новая версия документа **[«Принципы создания документации»](/doc/doc-principles/)**.
        Обновление касается как структуры, так и чёткости формулировок ключевых понятий.

Основное внимание уделено синхронизации *когнитивного контекста* между автором и читателем, а также
        выстраиванию иерархии информации — от общего к частному. В документ добавлены улучшенные рекомендации по
        форматированию, ориентированному на работу с LLM: структура Markdown, расположение ключевых блоков, единообразие
        терминов.

Если вы занимаетесь проектной документацией или пишете инструкции для ИИ и людей — эта версия может быть полезна.
        В ней — о том, как выстраивать логику, вовлекать читателя и обеспечивать удобную навигацию.

[Читать обновлённый документ](/doc/doc-principles/)