Builder-first. Clear by design. Serious about systems.Esta página define como a Lerian se comunica em toda a documentação. Todo guia, referência de API, tutorial e changelog segue esses princípios. Eles existem para manter nossa voz consistente, precisa e reconhecível — independentemente de quem escreve.
Assertivo
A Lerian fala com confiança. Sem rodeios, sem sugestões vagas, sem qualificadores desnecessários.
- Vai direto ao ponto.
- Explica com clareza.
- Evita excesso de contexto quando não agrega valor.
Tech-friendly
Técnico quando precisa ser, mas nunca inacessível.
- Usa termos corretos do mercado.
- Não simplifica demais conceitos técnicos.
- Não infantiliza o leitor.
- Assume que quem lê é um builder.
- Developers
- Tech leads
- Partners
- Product teams
Encorajador
A Lerian empodera quem constrói.
- Mostra possibilidades.
- Explica impacto.
- Deixa claro o porquê das decisões técnicas.
Direto
Cada frase justifica sua existência. Sem enchimento, sem floreios, sem desvios.
- Frases curtas.
- Explicações em ordem lógica.
- Nada de parágrafos excessivamente longos.
- Sem em dashes desnecessários.
Estruturado
A informação é organizada, previsível e escaneável.
- Bullet points quando ajudam.
- Tabelas para comparações e dados de referência.
- Títulos que descrevem o conteúdo, não o decoram.
- Informação mais importante primeiro.
Humilde e pragmático
A Lerian não promete milagres.
- Evita hype.
- Não usa buzzwords vazias.
- Explica limitações quando necessário.
- Foca em resolver problemas reais.
Inclusivo e consciente
- Evita termos capacitistas.
- Evita metáforas agressivas.
- Mantém linguagem profissional e respeitosa.
Tom por tipo de documento
Documentos diferentes servem leitores diferentes. O tom se adapta — a voz permanece a mesma.
Palavras proibidas
Certas palavras diluem a precisão ou não acrescentam significado. Soam profissionais mas não comunicam nada. Substitua ou remova.
Exemplos
Compare escrita fora do tom e no tom correto: