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.

La capa de lectura rápida

Los textos técnicos largos se hojean antes de leerse, y se vuelven a consultar después. La negrita marca las decisiones, para que quien recorre la página en diagonal se lleve igualmente las conclusiones. Los enlaces llevan cada afirmación a la pieza que la sostiene. Un artículo puede usar una sola línea destacada decorativa para su regla más afilada, colocada donde la prosa se hace más densa. Esa línea se gana el sitio condensando el tramo que la rodea. Si repite el párrafo de al lado, es relleno disfrazado de énfasis; mejor ninguna que una que no se lo haya ganado. Los bloques semánticos de peligro, consejo, advertencia e información son otra cosa: usa tantos como pida el contenido cuando cada uno cumpla su función. Un tramo de varios cientos de palabras merece una revisión: déjalo intacto si cumple una sola función coherente, o divídelo con un bloque de código, una tabla, una imagen, un aviso o una línea destacada que aporte algo. El énfasis repartido por todas partes no enfatiza nada.

Editar después del borrador

Un borrador técnicamente correcto puede conservar el andamiaje del editor. El historial de versiones, las alternativas descartadas y los detalles de verificación solo se quedan cuando cambian lo que el lector construye, diagnostica o decide.

• Un mecanismo o una decisión por párrafo. La evidencia y la consecuencia pueden acompañarlos; una segunda cadena causal empieza otro párrafo.
• Repite la revisión de lectura rápida después del último recorte. Al acortar cambia qué decisiones merecen negrita, y un énfasis anterior puede convertirse en una repetición.
• Vincula las Fuentes a las afirmaciones que sobreviven. Cuando una afirmación sale del cuerpo, elimina también su fuente; la lista documenta lo publicado, no el historial de navegación del editor.

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». Hay una cuarta que va con ellas, porque es la que un corrector no puede detectar. Cuando un texto explica por qué algo se comporta como lo hace, esa explicación se comprueba contra la cosa misma (el código de la librería, la documentación del fabricante, el código etiquetado al que enlaza) antes de publicarse. Un arreglo confirmado viéndolo funcionar merece una frase sobre lo que se vio; no merece un mecanismo que nadie ha leído. Y una corrección no termina en la línea corregida: después se relee la pieza entera, porque una afirmación arreglada en un párrafo puede seguir contradicha tres párrafos más abajo. Cuando la prosa y el código publicado no coinciden, la primera pregunta es cuál de los dos debe cambiar: a veces lo honesto es arreglar el código, para que la frase pase a ser cierta. Y las instrucciones de un tutorial responden al mismo listón que sus afirmaciones: los pasos se repiten desde el punto de partida exacto que nombra la pieza, en un directorio limpio, y el resultado se compara con la referencia terminada, porque el paso que la máquina del autor ya no necesita es justo el que el lector no puede saltarse. Las versiones se nombran, no se dan por supuestas: una instalación sin fijar responde a lo que el registro sirva ese día, y el lector sigue la pieza otro día distinto. Y lo que una pieza publica en un registro no se publica dos veces: una versión, una vez liberada, conserva sus bytes para siempre, y cualquier cambio sale como versión nueva, porque el lockfile del lector recuerda lo que el autor sobrescribió después. Una página que no llega a renderizarse es un fallo que el pipeline debe rechazar, no un aviso que registra: la puerta de compilación compara cada página publicada con su fuente y detiene el despliegue cuando un cuerpo queda incompleto. Y una puerta de control se audita como cualquier afirmación: una comprobación que solo inspecciona lo que ya existe, o que cuenta en un ámbito más amplio que lo que protege, aprueba compilaciones que debería rechazar; los puntos ciegos de la puerta también son hallazgos. Y una prueba responde a la misma disciplina: una suite que ejercita una imitación de lo que dice probar demuestra la imitación, así que la aserción se conecta al código real —el reductor real, el límite real— antes de que su verde signifique algo.

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.