Redacción

Frases

La frase por defecto pone primero el sujeto, luego el verbo, luego el objeto, y para. La mayoría de las frases del sitio se construyen así a propósito: la escritura sirve a cuatro idiomas, y muchos lectores la leen en una lengua que no es la suya. Una frase llana no les pide nada extra; la construcción ingeniosa se reserva para el momento de cada sección donde el argumento llega a su punto más alto.

• Aperturas invertidas. Una frase que retiene su sujeto hace esperar al lector. «El tercer arreglo se convierte en una factura de mantenimiento» gana a «lo que se convierte en silencio en una factura de mantenimiento es el tercer arreglo».
• Abstracciones animadas. Una razón no rinde frutos y una release no se aparta. Las cosas sin vida se describen, no reciben verbos de persona: «acabas construyendo a mano lo que una biblioteca te daría gratis».
• Colas decorativas. Cuando el punto ya ha aterrizado, una cláusula ornamental colgada al final lleva ritmo pero no información, y llama la atención sobre la escritura. Se corta.
• El párrafo que no deja de demostrarse. Punto, evidencia, seguir. Un párrafo que reformula su punto con otras palabras se lee como desconfianza hacia el lector. Tapa su última frase: si el párrafo sigue aterrizando, esa frase sobra.

La prueba es leer el párrafo en voz alta. Cualquier frase que te haga volver atrás a buscar su sujeto se aplana, y una inversión por sección, colocada donde se la gana, es el techo.

Palabras llanas

Las palabras cortas y comunes ganan a las infladas. El vocabulario de marketing (robusto, sin fisuras, de vanguardia) afirma calidad en vez de mostrarla, así que un hecho concreto ocupa su lugar. Las transiciones de relleno y el acolchado latinizante siguen el mismo camino: usar antes que utilizar o apalancar, luego antes que posteriormente.

Una palabra recupera su sitio cuando es el término técnico literal: un framework de software es un framework, el dispatch dinámico es dinámico. El sentido de marketing de la misma palabra no califica nunca.

Tres reglas menores viajan con esta. Los modismos se sustituyen por su significado literal (difiere antes que «toma caminos separados»), para que un lector en segunda lengua nunca tenga que desplegar una frase doblada. Las siglas y los nombres de herramientas se deletrean en su primer uso: «SWC (el Speedy Web Compiler)». Y la construcción de balancín, «no es X, es Y», se reformula como la afirmación positiva, la mitad que lleva la información.

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.

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.

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.

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 va entre comas o paréntesis y una fila de metadatos separa sus partes con un punto medio. Tres puntos seguidos pertenecen al código, no a las frases. La raya es el signo más escaso del sitio: comas, dos puntos, paréntesis y puntos hacen el trabajo diario, y una raya usada en todas partes pierde su fuerza. Le quedan dos sitios: una etiqueta frente a su glosa, como en las filas de referencias, y el raro inciso que ningún signo más discreto puede sostener. Nunca empalma dos frases independientes; esa juntura pide un punto o dos puntos.

Enlaces

El texto del enlace describe adónde lleva. El sitio nunca enlaza las palabras click here o read more, ni un simple here o this; un enlace se lee como aquello a lo que apunta.

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.

Enlaces cruzados

Los posts se apuntan entre sí con libertad: una frase que menciona el post del refresco de tokens enlaza con él, con el texto del enlace nombrando el destino como arriba. Los enlaces pueden incluso apuntar a posts que aún no han salido. Un enlace a un post sin publicar se muestra como texto plano, así que nada da nunca un 404, y esas palabras se convierten solas en enlace cuando el destino se publica. Las referencias hacia delante se escriben una vez y se resuelven solas.

Cada post puede elegir a mano hasta tres posts relacionados; los que no eligen recurren a las etiquetas compartidas. Una estantería de lecturas adicionales completa eso con posts más discretos que el lector probablemente no conoce, con un tope de nueve en total, para que siga siendo una recomendación y no un archivo.

Dentro de una serie, anterior y siguiente se quedan dentro de la serie: la parte cinco apunta a las partes cuatro y seis, nunca a un post sin relación que se publicó al lado. Solo en los extremos de una serie las flechas pasan al post vecino por fecha.

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.

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».

Tres hábitos más mantienen honestos los argumentos. Una decisión de diseño se nombra como decisión, nunca vestida de ley natural: «el host es dueño de la navegación» es una elección de esta build, y decirlo invita al lector a seguir el razonamiento en vez de buscar contraejemplos. El «porque» se reserva para la causalidad que el texto ha mostrado; donde una afirmación descansa en inferencia o convención, la escritura dice «lo que sugiere» o «la razón habitual es». Y los encabezados describen encaje, no fracaso: «Dónde X tiene límites» antes que «Por qué X falla».

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.