Redacció

Frases

La frase per defecte posa primer el subjecte, després el verb, després l’objecte, i para. La majoria de frases del lloc es construeixen així a propòsit: l’escriptura serveix quatre idiomes, i molts lectors la llegeixen en una llengua que no és la seva. Una frase plana no els demana res extra; la construcció enginyosa es reserva per al moment de cada secció on l’argument arriba al punt més alt.

• Obertures invertides. Una frase que reté el seu subjecte fa esperar el lector. «El tercer arranjament es converteix en una factura de manteniment» guanya a «el que es converteix en silenci en una factura de manteniment és el tercer arranjament».
• Abstraccions animades. Una raó no dóna fruits i una release no es fa a un costat. Les coses sense vida es descriuen, no reben verbs de persona: «acabes construint a mà el que una biblioteca et donaria gratis».
• Cues decoratives. Quan el punt ja ha aterrat, una clàusula ornamental penjada al final porta ritme però no informació, i crida l’atenció sobre l’escriptura. Es talla.
• El paràgraf que no deixa de demostrar-se. Punt, evidència, continuar. Un paràgraf que reformula el seu punt amb altres paraules es llegeix com a desconfiança cap al lector. Tapa la seva última frase: si el paràgraf segueix aterrant, aquella frase sobra.

La prova és llegir el paràgraf en veu alta. Qualsevol frase que et faci tornar enrere a buscar el subjecte s’aplana, i una inversió per secció, col·locada on se la guanya, és el sostre.

Paraules planes

Les paraules curtes i comunes guanyen a les inflades. El vocabulari de màrqueting (robust, sense fissures, d’avantguarda) afirma qualitat en lloc de mostrar-la, així que un fet concret n’ocupa el lloc. Les transicions de farciment i l’encoixinat llatinitzant segueixen el mateix camí: fer servir abans que utilitzar, després abans que posteriorment.

Una paraula recupera el seu lloc quan és el terme tècnic literal: un framework de software és un framework, el dispatch dinàmic és dinàmic. El sentit de màrqueting de la mateixa paraula no qualifica mai.

Tres regles menors viatgen amb aquesta. Els modismes se substitueixen pel seu significat literal (difereix abans que «pren camins separats»), perquè un lector en segona llengua no hagi de desplegar mai una frase doblegada. Les sigles i els noms d’eines es despleguen al primer ús: «SWC (el Speedy Web Compiler)». I la construcció de balancí, «no és X, és Y», es reformula com l’afirmació positiva, la meitat que porta la informació.

Ortografia

La prosa és en anglès britànic: behaviour, colour, organise, licence. Les dues excepcions són deliberades i totes dues viuen en el codi, no en la prosa. Un identificador de codi conserva l'ortografia que fa servir la seva API, així que una propietat color continua sent color. I a tota l'escriptura sobre Module Federation, artifact és un terme tècnic (un mòdul publicat i versionat), de manera que conserva aquesta grafia mentre que la prosa corrent segueix escrivint artefact.

Majúscules

L'estil de frase és l'estil de la casa: els títols de pàgina, els encapçalaments de secció, els encapçalaments d'article, els botons i les etiquetes posen en majúscula la primera paraula i qualsevol nom propi, i res més. La navegació superior és l'única excepció permanent, que es manté en estil títol.

Dates

Les dates són britàniques. Una data d'article escriu el mes sencer: 29 March 2026. Un rang de càrrec abreuja el mes i manté l'any (Mar 2016 to the present), i un rang obert es tanca amb la paraula Present, mai amb un guió final.

Puntuació

La coma final de sèrie és l'opció per defecte: labels, hints, and states. Els signes d'exclamació queden fora de la prosa. La truncació i els estats de càrrega fan servir el caràcter únic de punts suspensius, un incís va entre comes o parèntesis, i una fila de metadades separa les seves parts amb un punt volat. Tres punts seguits pertanyen al codi, no a les frases. El guió llarg és el signe més escàs del lloc: comes, dos punts, parèntesis i punts fan la feina diària, i un guió usat pertot arreu perd la seva força. Li queden dos llocs: una etiqueta davant de la seva glossa, com a les files de referències, i el rar incís que cap signe més discret pot sostenir. Mai no empalma dues frases independents; aquella juntura demana un punt o dos punts.

Enllaços

El text de l'enllaç descriu on porta. El lloc mai no enllaça les paraules click here o read more, ni un here o un this solts; un enllaç es llegeix com allò que assenyala.

Noms de marca i de producte

Els noms de producte conserven la seva grafia i el seu ús de majúscules oficials. React Native i Module Federation són dues paraules en estil títol cadascun; Pokémon i Pokédex sempre porten l'accent; App Store són dues paraules. Quan un nom té una forma exacta, respecta-la en lloc d'endreçar-la.

Enllaços creuats

Els posts s’apunten entre si amb llibertat: una frase que esmenta el post del refresc de tokens hi enllaça, amb el text de l’enllaç anomenant la destinació com més amunt. Els enllaços poden fins i tot apuntar a posts que encara no han sortit. Un enllaç a un post sense publicar es mostra com a text pla, així que res no dona mai un 404, i aquelles paraules es converteixen soles en enllaç quan la destinació es publica. Les referències endavant s’escriuen una vegada i es resolen soles.

Cada post pot triar a mà fins a tres posts relacionats; els que no trien cauen a les etiquetes compartides. Una prestatgeria de lectures addicionals ho completa amb posts més discrets que el lector probablement no coneix, amb un topall de nou en total, perquè continuï sent una recomanació i no un arxiu.

Dins d’una sèrie, anterior i següent es queden dins de la sèrie: la part cinc apunta a les parts quatre i sis, mai a un post sense relació que es va publicar al costat. Només als extrems d’una sèrie les fletxes cauen al post veí per data.

Discrepar per escrit

L’escriptura tècnica d’aquí discrepa molt: dels valors per defecte, de llibreries populars, d’idees heretades. La regla és reforçar primer la postura contrària. S’exposa l’opció rival en la seva millor versió, se li reconeix el que fa bé, i després es mostra on deixa de funcionar per al cas concret. La discrepància arriba com una observació sobre encaix, no com una condemna.

Dos hàbits ho sostenen. El que no és absolut no s’escriu com a absolut: «X mai funciona» passa a ser «X no es va dissenyar per a Y». I no hi ha obertures defensives: les frases no comencen amb «Perquè quedi clar» ni «Només per aclarir».

Tres hàbits més mantenen honestos els arguments. Una decisió de disseny s’anomena com a decisió, mai vestida de llei natural: «el host és amo de la navegació» és una tria d’aquesta build, i dir-ho convida el lector a seguir el raonament en lloc de buscar contraexemples. El «perquè» es reserva per a la causalitat que el text ha mostrat; on una afirmació descansa en inferència o convenció, l’escriptura diu «el que suggereix» o «la raó habitual és». I els encapçalaments descriuen encaix, no fracàs: «On X té límits» abans que «Per què X falla».

Teasers socials

Quan un post es comparteix a LinkedIn, allò compartit és un teaser, no un resum. La seva única feina és obrir una bretxa de curiositat que l’article tanca: plantejar una tensió, anomenar un detall concret sense explicar-lo, i apuntar endavant. Si el lector queda satisfet sense fer clic, el teaser ha fallat.

• Uns 500 caràcters, amb cada frase guanyant-se el seu lloc.
• Sense enllaços al cos; l’enllaç va al primer comentari.
• De tres a cinc hashtags, no més.
• Sense signes d’exclamació i sense preguntes retòriques com a ganxo.
• Primera persona del singular, escrita des de l’autoritat sènior: sense autocrítica de cara a la galeria ni batalletes inventades.
• Mai no s’anomenen ocupadors ni projectes interns.