Redacción

Cómo se componen las palabras del sitio. Son las convenciones que la redacción ya sigue, leídas del propio sitio: el estándar público de salida, no el proceso que hay detrás.

Ortografía

La prosa usa inglés británico: behaviour, colour, organise, licence. Las dos excepciones son deliberadas y ambas viven en el código, no en la prosa. Un identificador de código conserva la grafía que use su API, así que una propiedad color se queda en color. Y en toda la documentación de Module Federation, artifact es un término técnico (un módulo publicado y versionado), por lo que conserva esa grafía mientras la prosa corriente sigue escribiendo artefact.

Hazlo

behaviour · colour · organise · optimise
Ortografía británica en la prosa. Los identificadores de código y los términos técnicos conservan su propia forma.

No lo hagas

behavior · color · organize · optimize
En la prosa no se usa ortografía estadounidense: eso pertenece solo al código.

Mayúsculas

La mayúscula inicial es el estilo de la casa: los títulos de página, los encabezados de sección, los títulos de artículo, los botones y las etiquetas ponen en mayúscula la primera palabra y cualquier nombre propio, nada más. La navegación superior es la única excepción permanente, que se mantiene con mayúscula en cada palabra.

Hazlo

Download CV · Back to blog · Browse by tag
Mayúscula inicial en encabezados, botones y etiquetas.

No lo hagas

Download Cv · Back To Blog · BROWSE BY TAG
Ni mayúscula en cada palabra ni todo en mayúsculas, fuera de la navegación superior.

Fechas

Las fechas son británicas. La fecha de un artículo escribe el mes completo: 29 March 2026. Un rango de puesto abrevia el mes y conserva el año (Mar 2016 to the present), y un rango abierto se cierra con la palabra Present, nunca con un guion final.

Hazlo

29 March 2026 · Mar 2016 - Present
Mes completo para las fechas de artículo, abreviado para los rangos; los rangos abiertos dicen Present.

No lo hagas

03/29/2026 · March 29th · 2016–now
Ni numérico, ni orden estadounidense, ni ordinal.

Puntuación

La coma serial es la opción por defecto: labels, hints, and states. Los signos de exclamación se quedan fuera de la prosa. El truncamiento y los estados de carga usan el carácter único de puntos suspensivos, un inciso lleva una raya con espacios y una fila de metadatos separa sus partes con un punto medio. Tres puntos seguidos pertenecen al código, no a las frases.

Hazlo

labels, hints, and states — one line · 10 min
Coma serial, el carácter de puntos suspensivos, una raya con espacios, un punto medio entre metadatos.

No lo hagas

labels, hints and states ... one line! - 10 min
Sin puntos suspensivos de tres puntos, sin exclamación, sin guion simple para un inciso.

Nombres de marca y de producto

Los nombres de producto conservan su ortografía y sus mayúsculas oficiales. React Native y Module Federation son dos palabras con mayúscula inicial cada uno; Pokémon y Pokédex llevan siempre la tilde; App Store son dos palabras. Cuando un nombre tiene una forma exacta, respétala en lugar de corregirla.

Hazlo

React Native · Pokédex · Module Federation
Respeta la forma oficial, con tildes incluidas.

No lo hagas

react native · Pokedex · module federation
Ni en minúsculas ni sin tildes.

Discrepar por escrito

La escritura técnica de aquí discrepa mucho: de los valores por defecto, de librerías populares, de ideas heredadas. La regla es reforzar primero la postura contraria. Se expone la opción rival en su mejor versión, se reconoce lo que hace bien, y después se muestra dónde deja de funcionar para el caso concreto. La discrepancia llega como una observación sobre encaje, no como una condena.

Hazlo

Why not MSW, Mirage, or a mock server?
Un encabezado real del blog: las alternativas reciben su mérito antes de argumentar la elección.

No lo hagas

Why MSW doesn’t work for E2E testing
La versión de confrontación se lee como una condena y pone al lector a la defensiva.

Dos hábitos lo sostienen. Lo que no es absoluto no se escribe como absoluto: «X nunca funciona» pasa a ser «X no se diseñó para Y». Y no hay aperturas defensivas: las frases no empiezan con «Para que quede claro» ni «Solo por aclarar».

Teasers sociales

Cuando un post se comparte en LinkedIn, lo compartido es un teaser, no un resumen. Su único trabajo es abrir una brecha de curiosidad que el artículo cierra: plantear una tensión, nombrar un detalle concreto sin explicarlo, y apuntar hacia delante. Si el lector queda satisfecho sin hacer clic, el teaser ha fallado.

  • Unos 500 caracteres, con cada frase ganándose su sitio.
  • Sin enlaces en el cuerpo; el enlace va en el primer comentario.
  • De tres a cinco hashtags, no más.
  • Sin signos de exclamación y sin preguntas retóricas como gancho.
  • Primera persona del singular, escrita desde la autoridad senior: sin autocrítica de cara a la galería ni batallitas inventadas.
  • Nunca se nombran empleadores ni proyectos internos.
¿Has visto algo mal en esta página? Escríbeme