---
title: "Понять"
description: "Осмыслить абстракции и ментальные модели, на которых построен продукт."
doc_version: "2025-01-09"
last_updated: "2026-08-09"
canonical_url: "https://7act.org/ru/actions/understand/"
language: "ru"
license: "CC BY 4.0"
---

# Понять

Программные продукты обычно строятся вокруг абстракций, которые трудно понять, хотя они принципиально важны для правильного использования приложения или сервиса. Концептуальную документацию не всегда читают в первую очередь, но часто используют вместе с материалами для исследования и практики, чтобы закрепить полученные знания.

Примеры документации, помогающей понять продукт: раздел [Kubernetes Concepts](https://kubernetes.io/docs/concepts/overview/components/), статья [Thinking in React](https://react.dev/learn/thinking-in-react) и материал [What is OLAP?](https://www.linode.com/docs/guides/what-is-olap/). Все они дают концептуальные объяснения идей, которые соответствующие продукты реализуют или вводят. Благодаря этому такие материалы выходят за пределы собственных продуктов и становятся универсальными учебными ресурсами.

Документацию для понимания трудно создавать и легко недооценить, но она также поддерживает образовательные инициативы — например, продуктовые академии или учебные курсы. Она ценна потому, что находится в самом центре [Circles of Product Truth](https://passo.uno/circles-product-truth/). Каждый комплект документации должен учитывать эту потребность.


## Что пользователь хочет сделать

Программные продукты строятся вокруг абстракций, которые трудно понять, хотя они принципиально важны для правильного использования. Концептуальная документация закрепляет знания наряду с исследованием и практикой.

## Признаки того, что документация этого не обеспечивает

- Пользователи умеют работать с продуктом, но не могут объяснить, почему он устроен именно так.
- Понятия объясняются только в комментариях к коду или во внутренних вики.
- Нет глоссария или концептуального руководства по основным абстракциям продукта.

## Два примера из практики

- [Kubernetes Concepts](https://kubernetes.io/docs/concepts/overview/components/)
- [Thinking in React](https://react.dev/learn/thinking-in-react)

## Распространённые типы контента

- DITA: <concept>, <glossentry>, <section>
- Diataxis: Объяснение
- Good Docs Project: Концептуальное руководство, Глоссарий

## Одна метрика

охват понятий — Доля основных абстракций, для которых существует отдельная концептуальная страница.

## Sitemap

- [Модель документации на основе семи действий](https://7act.org/ru/index.md)
- [Введение](https://7act.org/ru/rationale/index.md)
- [Действия](https://7act.org/ru/actions/index.md)
- [Оценить](https://7act.org/ru/actions/appraise/index.md)
- [Понять](https://7act.org/ru/actions/understand/index.md)
- [Исследовать](https://7act.org/ru/actions/explore/index.md)
- [Практиковаться](https://7act.org/ru/actions/practice/index.md)
- [Вспомнить](https://7act.org/ru/actions/remember/index.md)
- [Разрабатывать](https://7act.org/ru/actions/develop/index.md)
- [Устранить неполадки](https://7act.org/ru/actions/troubleshoot/index.md)
- [Глоссарий](https://7act.org/ru/glossary/index.md)
- [Skill модели документации на основе семи действий](https://7act.org/ru/skill/index.md)