Contribuir com Documentação — Guia Escritores
Como contribuir com a documentação do OpenClaw. Guia para escritores e tradutores.
⏱️ 2 min de leitura
Contribuir com Documentação
A documentação é tão importante quanto o código. Veja como ajudar.
- Ajuda novos usuários
- Torna OpenClaw acessível globalmente
- Reconhecimento na comunidade
- Melhora suas habilidades de escrita técnica
- Erros de português/gramática
- Links quebrados
- Informação desatualizada
- Código que não funciona
- Exemplos mais claros
- Explicações mais detalhadas
- Screenshots e diagramas
- Casos de uso reais
- Tutoriais
- Guias de integração
- Receitas/automações
- Traduções
# Clone o repo de docs
git clone https://github.com/openclaw/docs
cd docs
git checkout -b docs/minha-contribuicao
Docs usam Markdown. Estrutura:
content/
├── guias/
├── tutoriais/
├── integracoes/
├── receitas/
└── faq/
# Se usa Hugo
hugo server -D
# Veja em localhost:1313
git add .
git commit -m "docs: adiciona tutorial de X"
git push origin docs/minha-contribuicao
Abra Pull Request no GitHub.
- Direto - Vá ao ponto
- Amigável - Não seja robótico
- Prático - Exemplos reais
# Título Principal (H1)
## Seções (H2)
### Subseções (H3)
**Negrito** para ênfase
`código` para inline
---
title: "Título da Página"
description: "Descrição para SEO"
tags: ["tag1", "tag2"]
---
# Título
Introdução em 1-2 parágrafos.
## Primeira Seção
Conteúdo...
## Segunda Seção
Conteúdo...
## Próximos Passos
Links relacionados.
- Título claro e descritivo
- Descrição com palavras-chave
- Introdução explica o objetivo
- Exemplos de código funcionam
- Links internos para relacionados
- Sem erros de português
- Formatação consistente
- Use exemplos reais
- Inclua output esperado
- Explique o “porquê”, não só o “como”
- Adicione links para aprofundar
- Parágrafos muito longos
- Jargão sem explicação
- Informação redundante
- Assumir conhecimento prévio
Contribuidores são listados em:
- CONTRIBUTORS.md
- Página de agradecimentos
- Release notes (para contribuições significativas)
- Discord: Canal #docs
- GitHub: Abra uma issue
- Email: docs@clawd.bot