---
title: "Compreender"
description: "Compreender as abstrações e os modelos mentais em que o produto se baseia."
doc_version: "2025-01-09"
last_updated: "2026-08-24"
canonical_url: "https://7act.org/pt-br/actions/understand/"
language: "pt-BR"
license: "CC BY 4.0"
---

# Compreender

Os produtos de software geralmente são construídos em torno de abstrações difíceis de compreender, mas fundamentais para o uso correto de uma aplicação ou serviço. Embora a documentação conceitual nem sempre seja consultada primeiro, é frequentemente usada em conjunto com a documentação de exploração e prática para consolidar o aprendizado.

Exemplos de documentação que ajuda a compreender são [Concepts do Kubernetes](https://kubernetes.io/docs/concepts/overview/components/), [Thinking in React](https://react.dev/learn/thinking-in-react) e [What is OLAP?](https://www.linode.com/docs/guides/what-is-olap/). Todos oferecem explicações conceituais sobre ideias que implementam ou introduzem. Ao fazer isso, ultrapassam as fronteiras dos próprios produtos e se tornam materiais de aprendizado universais.

Embora seja difícil de produzir e fácil de subestimar, a documentação que promove a compreensão também serve a iniciativas educacionais, como academias de produto ou salas de aula. É valiosa porque está no centro dos [Circles of Product Truth](https://passo.uno/circles-product-truth/). Todo conjunto de documentação deve atender a essa necessidade.


## O que o usuário quer fazer

Os produtos de software se baseiam em abstrações difíceis de compreender, mas fundamentais para o uso correto. A documentação conceitual consolida o aprendizado ao lado da exploração e da prática.

## Sinais de que a documentação não atende a essa necessidade

- Os usuários conseguem operar o produto, mas não explicar por que ele funciona daquele jeito.
- Os conceitos só são explicados em comentários no código ou em wikis internos.
- Não existe um glossário ou guia conceitual para as abstrações fundamentais do produto.

## Dois exemplos reais

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

## Tipos de conteúdo comuns

- DITA: <concept>, <glossentry>, <section>
- Diataxis: Explicação
- Good Docs Project: Guia conceitual, Glossário

## Uma métrica

cobertura de conceitos — Proporção das abstrações fundamentais com uma página conceitual dedicada.

## Sitemap

- [Modelo de documentação de sete ações](https://7act.org/pt-br/index.md)
- [Introdução](https://7act.org/pt-br/rationale/index.md)
- [Ações](https://7act.org/pt-br/actions/index.md)
- [Avaliar](https://7act.org/pt-br/actions/appraise/index.md)
- [Compreender](https://7act.org/pt-br/actions/understand/index.md)
- [Explorar](https://7act.org/pt-br/actions/explore/index.md)
- [Praticar](https://7act.org/pt-br/actions/practice/index.md)
- [Recordar](https://7act.org/pt-br/actions/remember/index.md)
- [Desenvolver](https://7act.org/pt-br/actions/develop/index.md)
- [Resolver](https://7act.org/pt-br/actions/troubleshoot/index.md)
- [Glossário](https://7act.org/pt-br/glossary/index.md)
- [Skill do modelo de documentação de sete ações](https://7act.org/pt-br/skill/index.md)