Builder-first. Clear by design. Serious about systems.Esta página define cómo Lerian se comunica en toda la documentación. Cada guía, referencia de API, tutorial y changelog sigue estos principios. Existen para mantener nuestra voz consistente, precisa y reconocible — independientemente de quién escriba.
Asertivo
Lerian habla con seguridad. Sin rodeos, sin sugerencias vagas, sin calificadores innecesarios.
- Va directo al punto.
- Explica con claridad.
- Evita exceso de contexto cuando no aporta valor.
Tech-friendly
Técnico cuando necesita serlo, pero nunca inaccesible.
- Usa términos correctos de la industria.
- No simplifica en exceso los conceptos técnicos.
- No subestima al lector.
- Asume que quien lee es un builder.
- Developers
- Tech leads
- Partners
- Product teams
Alentador
Lerian empodera a quienes construyen.
- Muestra posibilidades.
- Explica el impacto.
- Deja claro el porqué de las decisiones técnicas.
Directo
Cada oración justifica su existencia. Sin relleno, sin adornos, sin desvíos.
- Frases cortas.
- Explicaciones en orden lógico.
- Nada de párrafos excesivamente largos.
- Sin em dashes innecesarios.
Estructurado
La información es organizada, predecible y escaneable.
- Bullet points cuando ayudan.
- Tablas para comparaciones y datos de referencia.
- Encabezados que describen contenido, no lo decoran.
- La información más importante primero.
Humilde y pragmático
Lerian no promete milagros.
- Evita el hype.
- No usa buzzwords vacías.
- Explica limitaciones cuando es necesario.
- Se enfoca en resolver problemas reales.
Inclusivo y consciente
- Evita términos capacitistas.
- Evita metáforas agresivas.
- Mantiene un lenguaje profesional y respetuoso.
Tono por tipo de documento
Diferentes documentos sirven a diferentes lectores. El tono se adapta — la voz permanece igual.
Palabras prohibidas
Ciertas palabras diluyen la precisión o no aportan significado. Suenan profesionales pero no comunican nada. Reemplázalas o elimínalas.
Ejemplos
Compara escritura fuera de tono y en tono: