---
title: "Avaliar"
description: "Discernir as principais qualidades do produto e, se for o caso, compará-lo com outros."
doc_version: "2025-01-09"
last_updated: "2026-08-24"
canonical_url: "https://7act.org/pt-br/actions/appraise/"
language: "pt-BR"
license: "CC BY 4.0"
---

# Avaliar

Os usuários da documentação são também potenciais clientes ou adotantes. Um produto ou projeto de software prospera quando o número de usuários ativos aumenta. Quem lê a documentação deve conseguir discernir as principais qualidades do produto e, se for o caso, compará-lo com outros. Trata-se de um processo de descoberta.

Dois exemplos de documentação que abordam a avaliação de forma mais ou menos explícita são [What is Databricks?](https://docs.databricks.com/en/introduction/index.html) e a [Splunk Observability Cloud Service Description](https://docs.splunk.com/observability/en/get-started/service-description.html), que eu criei. Apresentam os principais pontos fortes e o posicionamento do produto, junto com informações que ajudam os potenciais clientes a decidir se devem seguir em frente.

Essa dimensão de venda discreta é frequentemente negligenciada pelos frameworks de documentação, deixando que o SEO e o marketing conduzam a documentação para algo que já não é documentação. Quando a documentação é produzida com a avaliação em mente, fica mais fácil manter o marketing sob controle e também se abre a possibilidade de usar métricas de conversão.


## O que o usuário quer fazer

Os usuários da documentação são também potenciais clientes ou adotantes. Quem lê deve conseguir discernir as principais qualidades do produto e compará-lo com outros. Trata-se de um processo de descoberta.

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

- As equipes de suporte e vendas respondem repetidamente às mesmas perguntas: “O que é isso?”
- Os potenciais clientes descobrem o que o produto faz no material de marketing, não na documentação.
- Não existe uma página que apresente o posicionamento ou os principais pontos fortes do produto.

## Dois exemplos reais

- [What is Databricks?](https://docs.databricks.com/en/introduction/index.html)
- [Splunk Observability Cloud Service Description](https://docs.splunk.com/observability/en/get-started/service-description.html)

## Tipos de conteúdo comuns

- DITA: <topic>, <concept>
- Diataxis: Sem equivalente direto (o mais próximo é Explicação)
- Good Docs Project: Visão geral, Página de destino

## Uma métrica

conversão — Taxa de conversão da documentação para a adoção do produto.

## 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)