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

# Avaliar

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

Dois exemplos de documentação (criados por mim) 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). Ambos apresentam os principais pontos fortes e o posicionamento do produto, juntamente com informações que ajudam os potenciais clientes a decidir se devem avançar.

Esta dimensão de venda discreta é frequentemente negligenciada pelas 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, torna-se mais fácil manter o marketing sob controlo e abre-se também a possibilidade de utilizar métricas de conversão.


## O que o utilizador quer fazer

Os utilizadores da documentação são também potenciais clientes ou avaliadores. 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 responde a esta necessidade

- As equipas de apoio e vendas respondem repetidamente às mesmas perguntas: «O que é isto?»
- 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 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)