---
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-09-07"
canonical_url: "https://7act.org/pt-pt/actions/understand/"
language: "pt-PT"
license: "CC BY 4.0"
---

# Compreender

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

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 os exemplos oferecem explicações conceptuais sobre as ideias que implementam ou introduzem. Ao fazê-lo, ultrapassam as fronteiras dos próprios produtos e tornam-se materiais de aprendizagem universais.

Embora seja difícil de produzir e fácil de subestimar, a documentação que promove a compreensão também serve iniciativas educativas, como academias de produto ou salas de aula. É valiosa porque se encontra no centro dos [Circles of Product Truth](https://passo.uno/circles-product-truth/). Todos os conjuntos de documentação devem responder a esta necessidade.


## O que o utilizador quer fazer

Os produtos de software baseiam-se em abstrações difíceis de compreender, mas fundamentais para uma utilização correta. A documentação conceptual consolida a aprendizagem ao lado da exploração e da prática.

## Sinais de que a documentação não responde a esta necessidade

- Os utilizadores conseguem operar o produto, mas não explicar por que razão funciona daquela forma.
- Os conceitos só são explicados em comentários no código ou em wikis internos.
- Não existe um glossário ou guia conceptual 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 conceptual, Glossário

## Uma métrica

cobertura de conceitos — Percentagem das abstrações fundamentais com uma página conceptual dedicada.

## Sitemap

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