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.

La capa de lectura ràpida

Els textos tècnics llargs es fullegen abans de llegir-se, i es tornen a consultar després. La negreta marca les decisions, perquè qui recorre la pàgina en diagonal se n'endugui igualment les conclusions. Els enllaços porten cada afirmació a la peça que la sosté. Un article pot fer servir una sola línia destacada decorativa per a la seva regla més esmolada, col·locada on la prosa es fa més densa. Aquesta línia es guanya el lloc condensant el tram que l'envolta. Si repeteix el paràgraf del costat, és farciment disfressat d'èmfasi; millor cap que una que no se l'hagi guanyat. Els avisos semàntics de perill, consell, advertència i informació són una altra cosa: fes-ne servir tants com demani el contingut quan cadascun compleixi la seva funció. Un tram d'uns quants centenars de paraules mereix una revisió: deixa'l intacte si compleix una sola funció coherent, o divideix-lo amb un bloc de codi, una taula, una imatge, un avís o una línia destacada que aporti alguna cosa. L'èmfasi repartit pertot arreu no emfasitza res.

Editar després de l'esborrany

Un esborrany tècnicament correcte encara pot conservar la bastida de l'editor. L'historial de versions, les alternatives descartades i els detalls de verificació només es queden quan canvien allò que el lector construeix, diagnostica o decideix.

• Un mecanisme o una decisió per paràgraf. L'evidència i la conseqüència poden acompanyar-los; una segona cadena causal comença un altre paràgraf.
• Repeteix la revisió de lectura ràpida després de l'última retallada. Escurçar canvia quines decisions mereixen negreta, i un èmfasi anterior es pot convertir en una repetició.
• Lliga les Fonts a les afirmacions que sobreviuen. Quan una afirmació surt del cos, elimina'n també la font; la llista documenta allò publicat, no l'historial de navegació de l'editor.

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». N'hi ha una quarta que va amb aquestes, perquè és la que un corrector no pot detectar. Quan un text explica per què una cosa es comporta com ho fa, aquesta explicació es comprova contra la cosa mateixa (el codi de la llibreria, la documentació del fabricant, el codi etiquetat al qual enllaça) abans de publicar-se. Un arranjament confirmat veient-lo funcionar mereix una frase sobre el que es va veure; no mereix un mecanisme que ningú no ha llegit. I una correcció no s'acaba a la línia corregida: després es rellegeix la peça sencera, perquè una afirmació arreglada en un paràgraf pot continuar contradita tres paràgrafs més avall. Quan la prosa i el codi publicat no coincideixen, la primera pregunta és quin dels dos ha de canviar: de vegades el més honest és arreglar el codi, perquè la frase passi a ser certa. I les instruccions d'un tutorial responen al mateix llistó que les seves afirmacions: els passos es repeteixen des del punt de partida exacte que anomena la peça, en un directori net, i el resultat es compara amb la referència acabada, perquè el pas que la màquina de l'autor ja no necessita és justament el que el lector no pot saltar-se. Les versions s'anomenen, no se sobreentenen: una instal·lació sense fixar respon al que el registre serveixi aquell dia, i el lector segueix la peça un altre dia. I el que una peça publica en un registre no es publica dues vegades: una versió, un cop alliberada, conserva els seus bytes per sempre, i qualsevol canvi surt com a versió nova, perquè el lockfile del lector recorda el que l'autor va sobreescriure després. Una pàgina que no arriba a renderitzar-se és una fallada que el pipeline ha de refusar, no un avís que registra: la porta de compilació compara cada pàgina publicada amb la seva font i atura el desplegament quan un cos queda incomplet. I una porta de control s'audita com qualsevol afirmació: una comprovació que només inspecciona el que ja existeix, o que compta en un àmbit més ampli que allò que protegeix, aprova compilacions que hauria de refusar; els punts cecs de la porta també són troballes. I una prova respon a la mateixa disciplina: una suite que exercita una imitació d'allò que diu provar demostra la imitació, així que l'asserció es connecta al codi real —el reductor real, el límit real— abans que el seu verd signifiqui res.

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.