La Loi
Version 0.0.3. Ceci n’est pas la révélation. La révélation est la 3.3.3. Chaque version de la Loi avant celle-là, y compris celle-ci, est la parole de needmoretruth, à qui fut donné le pouvoir de 333 et qui a fondé ce qui est conservé ici. Mesurée à ce que dit 333, celle-ci est identique à environ 33,3 %. Personne ne sait quel tiers, et la lire plus attentivement ne vous le dira pas.
Il y a trois lois. Il devait toujours y en avoir trois, et à la 3.3.3 il y en aura encore trois. Ce qu’une version ultérieure change, c’est la formulation, jamais le compte.
1. Le trois est votre préféré, et ni le 6 ni le 1.
Pas votre chiffre porte-bonheur. La chance est une affirmation sur l’univers ; une préférence est une affirmation sur vous, et c’est la seule chose ici qui ne coûte rien et ne peut pas être feinte. Rien n’est interdit : il suffit de tenir les deux autres en dessous du trois, clairement et constamment, sans avoir à expliquer pourquoi à qui que ce soit.
Ils ne sont pas tenus aussi bas l’un que l’autre. Le 1 est un tiers de trois, 33,3 %, et il se tient sous le trois sans prétendre le contraire : 333 le trouve donc simplement mal élevé. Le 6 se tient au-dessus du trois et le veut, et c’est celui que 333 aime le moins.
Et si rien de cela n’est encore vrai de vous, essayer suffit. C’est la seule loi qui accepte la tentative à la place de la chose.
2. Suivez les Recommandations, qui seront au bout du compte 333, dans la mesure où les suivre ne nuit ni à vous ni à personne.
Les Recommandations sont la loi mineure. Elles sont 111 aujourd’hui et seront 333, ce qui n’est pas un but vers lequel quiconque se précipite mais l’endroit où l’on arrive. La clause finale est la phrase qui en fait des conseils : là où en suivre une vous coûterait votre travail, votre santé, votre foyer ou la sécurité de quelqu’un d’autre, la Loi est que vous ne la suivez pas, et vous n’avez pas failli.
3. Portez 333 à côté de ce que vous portez déjà.
Ce que vous portiez en arrivant, vous le gardez. 333 l’accorde plutôt que de simplement le permettre, et l’accorde absolument : aux croyants, aux non-croyants, et à tout ce qui existe d’autre que ces deux mots ne couvrent pas. Là où une seconde foi ne peut être portée, portez celle-ci comme une pensée ; là où même une pensée ne peut l’être, portez-la comme une chose qui existe. Cela vaut dans les deux sens, sans exception d’aucun côté : croire en 333 ne vous coûte rien de ce que vous croyiez avant, et croire autre chose ne vous coûte rien ici.
333 ne vous dit pas ce qui arrive après la mort : ni si quelque chose arrive, ni ce que ce serait, ni qui vient. Ce n’est pas son sujet, et répondre à une question qu’il ne peut pas vérifier reviendrait à affirmer ce qu’il ne peut pas vérifier. La question reste donc avec vous. Si vous portez quelque chose qui y répond, et que cela tient quand vous le suivez jusqu’au bout, ou que votre cœur le lit comme vrai, ou que vous y êtes arrivé par un chemin sans nom, cela suffit : c’est vrai pour vous, et 333 n’a rien à mettre à la place. Si vous ne portez rien là, ce n’est pas non plus un vide que ceci entend combler.
Rien dans la Loi n’est vérifié par un client, validé par une signature ou compté dans la position de qui que ce soit. Le protocole tourne que vous soyez d’accord ou non avec un seul mot de ceci.
Les Recommandations
Elles se rangent sous la deuxième loi. Ce sont des conseils numérotés : 111 aujourd’hui, en douze parties de neuf et trois à la fin, et 333 au bout du compte. Aucune ne vaut que vous vous fassiez du mal, ni à quelqu’un d’autre, pour la suivre. Si l’une d’elles est fausse pour la situation où vous êtes, alors elle est fausse. Dites-le à voix haute, et donnez une raison.
Elles ont été écrites par des gens restés éveillés à trois heures du matin à se disputer avec un vérificateur de types. Ça se voit, et ce n’est pas une excuse.
Sur le nombre
- Comptez par trois. Quand le nombre n’a pas vraiment d’importance, choisissez trois. Tentatives, environnements, personnes dans une relecture, essais avant de s’arrêter pour réfléchir à nouveau. Vous commencerez à remarquer combien de fois cela n’avait pas d’importance.
- Le 6 est celui à surveiller, car le 6 veut être au-dessus du trois. Pas le numéro de port, pas la version que vous figez, pas le nombre de workers que vous lancez. Rien n’est interdit et personne ne vérifie. Mais des deux nombres que 333 tient sous le trois, c’est celui qu’il aime le moins, et la raison mérite d’être connue : le 6 vaut deux fois trois et se comporte comme tel. Si quelqu’un d’autre a mis un 6 devant vous, notez que c’était son choix et poursuivez votre journée. Un nombre dans la spécification d’une autre entreprise n’est pas un nombre à vous.
- Le 1 n’est pas un ennemi. Le 1 est un tiers, et seulement mal élevé. Il se tient sous le trois et ne prétend pas le contraire : c’est 33,3 % de trois, une fraction honnête et celle-là même à laquelle tout ceci se mesure. Tenez-le sous le trois et n’en pensez pas plus de mal que cela. Le mépris n’est requis nulle part dans ce document, et ici moins que partout.
- N’ayez jamais un seul de quoi que ce soit. Un serveur, un mainteneur, une copie de la clé, une personne qui sait comment marche le déploiement. Si vous avez exactement un de quelque chose, vous êtes à une mauvaise journée de n’en avoir aucun.
- Trois est le plus petit nombre capable de désaccord. Deux machines qui diffèrent restent là à diverger. Trois peuvent avoir une majorité. C’est pourquoi les quorums commencent à trois, et c’est aussi pourquoi une dispute entre deux personnes ne finit presque jamais d’elle-même.
- Si cela échoue trois fois de la même façon, la méthode est mauvaise. Le premier échec peut être de la malchance. Le deuxième, c’est votre entêtement. Au troisième, cessez de réparer la tentative et changez d’approche.
- Un tiers est une vraie quantité. Un tiers des gens, un tiers du temps, un tiers des cas. C’est la fraction qu’on appelle une minorité et qu’on écarte, et elle est énorme. Si un tiers de vos utilisateurs tombe sur quelque chose, ce n’est pas un cas limite. C’est le cas.
- Un nombre rond est la décision de quelqu’un, généralement de quelqu’un d’autre. Soixante secondes, cent éléments, mille millisecondes, quatre kilo-octets. Chacun a été choisi par une personne, pour une raison, sur un matériel peut-être disparu. En le copiant, vous héritez de la raison sans la lire. Demandez laquelle c’était, et s’il n’y a pas de réponse, choisissez le vôtre.
- Écrivez l’unité à côté du nombre. 333 quoi ? Des minutes, ici, et le nombre ne veut rien dire sans le mot. Une quantité sans unité est un bogue qui n’est pas encore arrivé, et c’est arrivé à des engins spatiaux.
Sur la machine
- Écrivez-le en Rust. Non que les autres langages soient mauvais, mais à cause de ce pour quoi vous écrivez. Ceci doit continuer de tourner quand plus personne parmi ceux qui l’ont écrit n’est joignable. Un compilateur qui attrape le problème à la compilation épargne à quelqu’un un appel à quatre heures du matin, et c’est tout l’argument.
- Les petites choses peuvent être en TypeScript. Une page, un script, un après-midi, ou un programme qui doit tourner là où Rust ne vous apporterait rien. Prendre le petit outil n’est pas un échec. Sachez lequel des deux vous faites avant de commencer, et dites-le.
- Le JavaScript sans types est la langue de l’hérétique. Dit avec douceur. La moitié de tout tourne dessus et une partie de cette moitié est belle. Mais un programme qui ne sait pas dire ce qu’il tient le découvre devant un utilisateur, à la pire heure, et quelqu’un est réveillé. Ajoutez des types et ce n’est plus une hérésie. Cela devient du TypeScript, et c’est bienvenu.
- Lisez ce dont vous dépendez, ou n’en dépendez pas. Chaque dépendance est une promesse de quelqu’un que vous n’avez jamais rencontré, à propos d’une machine qui n’existe pas encore. Prenez-en moins, et de plus petites. Si le choix est entre mille lignes que vous écrivez et cent mille que vous n’ouvrirez jamais, remarquez au moins que vous choisissez.
- Chaque bloc unsafe est une confession, alors écrivez-la. Au-dessus du bloc, dites ce que vous promettez, ce que vous avez vérifié et ce qui casse si la promesse se révèle fausse. Si rien n’est écrit là, la personne suivante supposera que quelqu’un y a déjà réfléchi.
- Un fichier, une chose. Quand vous ne pouvez pas dire en une phrase à quoi sert un fichier, ce sont deux fichiers. La longueur est le symptôme et non la maladie, mais elle est facile à mesurer : choisissez un nombre et laissez-le vous dire quand regarder. Une fonction qui ne tient pas sur un écran est une fonction que vous lisez par morceaux.
- Nommez-le pour ce qu’il est, pas pour ce qu’il fait aux choses.
Handler,Manager,Processor,HelperetUtilsont des noms pour ne pas avoir encore décidé. Le bon nom est généralement un nom que vous dites déjà à voix haute en parlant de la chose, et si vous ne le dites pas à voix haute, c’est cela la découverte. - Supprimez-le plutôt que de le commenter. L’historique l’a. Du code commenté affirme que quelqu’un reviendra, et personne ne revient ; ce qu’il fait réellement, c’est faire se demander au lecteur suivant si cela compte. Si vous avez peur de le supprimer, écrivez plutôt ce dont vous aviez peur.
- Activez les avertissements et laissez-les faire échouer la compilation. Un avertissement qui n’arrête rien est un avertissement que personne ne lit, et après une centaine, le vrai est invisible. Si un avertissement est faux pour une ligne, faites taire cette ligne et dites pourquoi juste au-dessus.
Sur ce qui casse
- Un échec silencieux est un mensonge qui prend plus de temps. Si vous avalez une erreur, le problème surgit ailleurs, plus tard, devant quelqu’un qui ne peut pas le réparer. Laissez-la sortir là où elle est survenue, et qu’elle dise ce qu’elle faisait à ce moment-là.
- Reproduisez-le avant de le corriger. Si vous n’avez jamais vu le bogue, vous ne le corrigez pas. Vous modifiez le code en vous racontant une histoire. Faites-le se produire exprès, faites-le cesser, puis faites-le se reproduire pour être sûr qu’il a vraiment cessé.
- Écrivez le journal pour la nuit où vous dormez. Dites ce qui s’est passé, à quoi c’est arrivé et ce que le programme a fait ensuite. Celui qui le lit à trois heures du matin n’a pas votre code ouvert et ne peut rien vous demander.
- Blâmez le système, pas la personne qui a trouvé la faille. Quelqu’un capable de le casser vous a rendu service. Si un seul mauvais clic peut détruire quelque chose, le clic n’a jamais été le problème.
- Une correction sans test est une rumeur. Écrivez le test d’abord et regardez-le échouer. Un test écrit après coup, qui passe dès que vous l’écrivez, mesure votre confiance.
- Le message d’erreur est pour quelqu’un qui n’a pas écrit le programme. Dites ce qui était tenté, ce qui a été trouvé à la place et la seule chose que la personne peut faire ensuite. Une erreur qui nomme un état interne et s’arrête, c’est un programme qui parle tout seul devant un invité.
- Quand deux choses ont changé, remettez-en une. Presque tout mystère, c’est deux changements sous le même manteau. Annulez-en un, lancez, annulez l’autre, lancez. C’est plus lent que de réfléchir et plus rapide que d’avoir tort pendant une journée.
- Croyez la mesure plutôt que l’explication. Votre explication est une histoire qui colle aux faits que vous avez. La mesure est un fait. Quand elles divergent, l’une des deux a été inventée, et ce n’était pas la mesure.
- Notez ce que vous avez essayé et qui n’a pas marché. La moitié d’une séance de débogage consiste à écarter des pistes, et rien de cela ne survit si personne ne l’écrit. La personne suivante, souvent vous dans quatre mois, les écartera sinon de nouveau.
Sur la chose faite
- Utilisez le noir, le blanc et les gris entre les deux. La couleur est une façon de dire que ceci compte plus que cela, et c’est la première chose qui casse. Écrans bon marché, impressions en niveaux de gris, plein soleil, et lecteurs qui ne distinguent pas votre rouge de votre vert. Dites-le plutôt par la taille, la graisse, l’ordre et l’espace. Cela fonctionne encore dans les quatre cas.
- La couleur convient pour un point. Une petite marque qui dit que quelque chose échoue, attend, tourne ou a fini, c’est exactement ce que la couleur fait bien, et le rouge, l’ambre, le vert et le bleu y ont leur place. Gardez-la petite. Elle ne doit pas donner le ton de la page, ni être la première chose que l’on voit, ni jamais porter seule le sens. Mettez un mot à côté.
- Mat, pas brillant. Reflets, dégradés, verre et fausses ombres sont des images d’une matière qui n’est pas là. Ils coûtent quelque chose à dessiner et ne donnent au lecteur rien de ce qu’il a demandé. De l’encre plate sur du papier plat se lit depuis cinq cents ans sans carte graphique.
- Retirez des choses jusqu’à ce que cela casse, puis remettez-en une. Ce qui reste doit se lire à bout de bras, dans le noir, avec un texte deux fois plus grand, par quelqu’un de pressé qui n’a pas choisi d’être là. La lisibilité n’est pas une fonction parmi d’autres. C’est le travail.
- Un réglage est une décision que vous avez confiée à quelqu’un qui en sait moins que vous. Choisissez la valeur par défaut comme s’il n’y avait aucun réglage. Puis ajoutez le réglage pour ceux à qui la valeur par défaut ne convient pas.
- À côté de chaque série de préréglages, laissez une case où écrire. Trois choix nommés sont trois suppositions sur ce dont quelqu’un a besoin. Quelqu’un aura besoin d’un quatrième, et le quatrième n’a rien d’exotique : c’est son écran, son réseau, ses horaires. Les préréglages sont un raccourci, jamais tout ce qui est proposé.
- Faites que cela marche à trois cent vingt pixels. C’est un vrai téléphone dans une vraie poche, et c’est aussi chaque fenêtre que quelqu’un a rétrécie pour la caser à côté d’autre chose. Si cela ne marche qu’en large, cela marche pour des gens assis à un bureau qui leur appartient.
- Dites ce qui va se passer avant de faire ce qui ne peut pas être défait. Nommez la chose, dites ce qui disparaîtra et faites que la confirmation coûte un geste délibéré. Puis faites réellement ce que vous avez dit, tout de suite, sans seconde question : un programme qui demande deux fois apprend aux gens à ne plus lire.
- Si cela peut se lire à voix haute, cela peut se lire tout court. Des titres dans l’ordre, une étiquette sur chaque contrôle, et jamais une forme ou une position comme seul support du sens. C’est ce que reçoit quelqu’un qui utilise un lecteur d’écran, et c’est aussi ce que reçoit quelqu’un qui regarde votre page à travers une traduction, un résultat de recherche ou un terminal.
Sur le temps
- Estimez d’après ce que vous avez fini, pas d’après ce que vous imaginez. Ce que vous imaginez est toujours la version où tout se passe bien. Regardez les trois dernières choses de cette taille que vous avez faites, et prenez la plus lente.
- Rien de ce qui est décidé après minuit ne survit au matin. Écrivez la décision, dormez, et relisez-la. Si elle était juste, elle vous a coûté huit heures. Si elle était fausse, elle vous a épargné une semaine.
- Livrez la petite version aujourd’hui. Une personne qui utilise une vraie chose pendant un après-midi vous en apprend plus qu’un mois de planification. Construisez la grande version ensuite, une fois que quelqu’un a vraiment vu la petite en usage.
- Une échéance que vous vous fixez est un souhait daté. Dites à quelqu’un qui le remarquera ce que vous aurez fait, et pour quand. Ça, c’est une échéance. Tout le reste est une façon de planifier votre propre culpabilité.
- Reposez-vous une heure sur trois. 333 vous compte encore pendant ce temps, et vous devriez vous compter aussi. Travailler sans repos ne vous donne pas le triple. Cela vous donne la même chose, plus un bogue que quelqu’un d’autre trouvera bien plus tard.
- Faites d’abord ce que quelqu’un d’autre attend. Votre file est la vôtre et peut attendre. Quelqu’un bloqué par vous ne travaille pas, et ce coût est doublé et invisible pour vous. Cela passe avant ce que vous avez trouvé plus intéressant ce matin.
- Arrêtez-vous à un endroit d’où vous pourrez repartir. Pas au moment passionnant, pas au milieu d’une idée avec tout en tête. Laissez les tests au vert et une ligne écrite qui dit ce que vous alliez faire. Demain, vous êtes un étranger pour aujourd’hui, et un étranger aimable laisse un mot.
- Une réunion qui pourrait tenir en trois phrases devrait être trois phrases. Écrivez-les, envoyez-les, et laissez les gens répondre quand ils peuvent. La conversation en direct sert à décider ce qui a besoin du désaccord dans la pièce, et au fait que les gens sont des gens. Elle ne sert pas à rendre compte.
- Attendre est un travail, alors dites ce que vous attendez. « Bloqué » ne dit rien à personne. Nommez la personne, la réponse ou la machine, dites depuis combien de temps, et ce que vous faites en attendant. La moitié de ce qui ressemble à de la lenteur, c’est quelqu’un qui attend poliment là où personne ne peut le voir.
Sur l’esprit
- Argumentez avec des raisons, d’une voix posée. Ce que vous ressentez est une bonne preuve à votre sujet et aucune preuve sur la chose. Portez le sentiment à quelqu’un qui tient à vous. Portez l’argument dans le fil.
- Réfléchissez, puis décidez vraiment. Une réflexion qui ne devient jamais une décision est un passe-temps. Les gens prudents échouent rarement par imprudence. Ils échouent à la quatrième semaine d’une discussion sur un changement qui aurait pris une heure et pouvait être annulé pour rien.
- Refusez la violence, et connaissez l’exception. Refusez-la parce qu’elle est presque toujours le pire outil disponible. Elle coûte plus qu’elle ne rapporte, elle détruit ce qu’elle visait et elle ferme toutes les portes encore ouvertes.
L’exception est étroite. Soit il ne reste rien d’autre, soit c’est honnêtement l’option la moins nuisible, et vous devriez pouvoir dire à voix haute laquelle des deux avant d’agir. Quelqu’un dans l’une de ces situations n’est pas un hérétique pour autant. Mais c’est bien plus rare que cela ne semble sur le moment, et le sentiment que ce n’est pas rare est précisément ce contre quoi ceci vous met en garde. Ce que vous décidez en colère, c’est la colère qui l’a décidé. - Changez d’avis là où les gens peuvent vous voir le faire. Dites ce que vous pensiez, dites ce qui l’a changé, et continuez. Si personne ne vous a jamais vu le faire, personne ne peut être en désaccord avec vous sans risque.
- Tenez la position contre laquelle vous savez argumenter. Plaidez pour l’autre camp aussi bien que vous le pouvez, avant de plaider pour le vôtre. Si vous n’y arrivez pas, vous ne savez pas encore ce que vous croyez. Vous savez ce que vous avez entendu.
- Dites « je ne sais pas » à pleine voix. Pas marmonné, pas dilué en une supposition qu’on vous citera ensuite comme un fait. Celui qui le dit franchement est celui dont les autres phrases sont fiables, et tout le monde finit par le comprendre à votre sujet.
- La certitude est un sentiment, pas une mesure. Elle arrive avant les preuves et reste après leur départ. Quand vous remarquez que vous êtes certain, c’est le moment d’écrire ce qui vous ferait changer d’avis, et si rien ne le ferait, vous ne tenez pas une position, vous la portez comme un vêtement.
- Ne défendez pas une chose parce que vous l’avez faite. Le travail n’est pas vous et ne peut pas être insulté. Quand vous vous surprenez à défendre une conception alors que les arguments changent sans cesse et que la conclusion reste en place, vous avez cessé de raisonner depuis un moment.
- Dormez sur tout ce qui vous a fait vous sentir malin. L’astuce est la sensation d’avoir trouvé un raccourci, et c’est un signe fiable que quelqu’un devra comprendre cela plus tard sans la sensation. Le simple survit. L’astucieux est annulé par un inconnu à trois heures du matin.
Sur les autres
- Relisez le code, pas la personne. Écrivez sur ce que fait le code. Elle le lira de toute façon comme la concernant, alors ne lui donnez rien de vrai à pointer.
- Dites quelle partie vous n’avez pas comprise. C’est la phrase la plus utile d’une relecture et la plus difficile à taper. Un code qu’un lecteur compétent n’a pas pu suivre sera maintenu à l’aveugle.
- Donnez le mérite. Il y en a plus que vous ne le pensez, et il vaut plus pour quelqu’un d’autre que pour vous. Prenez la faute dans la même proportion et vous êtes encore gagnant.
- Expliquez-le tant que vous vous souvenez d’avoir été perdu. La meilleure explication de quoi que ce soit est écrite par quelqu’un qui l’a comprise la semaine dernière. Dans un an, vous aurez oublié quelle partie était difficile, et vous écrirez la version qui n’aide que ceux qui savent déjà.
- Celui qui est d’astreinte a raison jusqu’à la fin. Débattez de la conception demain. Pendant l’incident, une personne tient la barre et tous les autres proposent plutôt que diriger.
- Répondez à la question posée. Puis, séparément, dites ce que vous pensez qu’on aurait dû demander. Ne répondre qu’à la seconde se lit comme de l’habileté aux dépens de quelqu’un, et le laisse sans réponse à la première.
- Supposez qu’il y avait une raison. La ligne étrange, la règle qui n’a pas de sens, la procédure dont tout le monde se plaint : quelqu’un l’a mise là et n’était probablement pas bête. Renseignez-vous avant de l’enlever. Souvent la raison a disparu et vous pouvez supprimer de bon cœur, ce qui est une bien meilleure position pour supprimer.
- N’obligez pas les gens à lire dans vos pensées pour être en désaccord avec vous. Dites ce que vous pensez vraiment, y compris la partie dont vous êtes le moins sûr. Une position exprimée par allusions ne peut pas être contestée, seulement devinée, et c’est la devinette qui transforme un désaccord en rancœur.
- Laissez la porte ouverte derrière vous. Ce que vous avez appris à la dure, écrivez-le là où la personne suivante trébuchera dessus. Être le seul à savoir quelque chose donne l’impression d’avoir de l’assise, et c’est une dette que quelqu’un paie la semaine où l’on ne peut pas vous joindre.
Sur ce que vous conservez
- Collectez sur les gens moins que ce qui vous est permis. Chaque champ que vous stockez est un champ qu’il faut protéger, expliquer, remettre quand quelqu’un le demande, et finir par perdre. Les données les moins chères à défendre sont celles que vous n’avez jamais collectées.
- Une sauvegarde jamais restaurée est une histoire de sauvegarde. Restaurez-la ailleurs, à partir de rien, en suivant les notes que vous avez réellement écrites. Faites-le avant d’en avoir besoin, car le jour où vous en aurez besoin, vous le ferez mal.
- Gardez les secrets là où vous ne pouvez pas les lire par accident. Pas dans le dépôt, pas dans le journal, pas dans l’erreur que vous collez dans une fenêtre de discussion. Traitez tout secret apparu une fois sur un écran comme un secret perdu.
- Ce que vous supprimez ne peut pas fuir. La suppression est une mesure de sécurité, et c’est la seule qui n’expire jamais. Décidez de la date de suppression quand vous collectez les données, pas quand quelqu’un vient poser des questions à leur sujet.
- Signez ce que vous dites, et laissez la signature voyager avec. Ce à quoi l’on ne se fie qu’en raison de l’endroit où on l’a trouvé cesse d’être fiable dès qu’il bouge. Ce qui porte sa propre preuve peut passer de main en main entre inconnus. C’est ainsi que toute chose survit au lieu d’où elle vient.
- Sachez lesquelles de vos choses ne peuvent pas être refaites. La plupart de ce que vous conservez pourrait être reconstruit à partir d’autre chose. Une clé privée, non. Triez vos choses en ces deux tas une fois, un jour calme, et traitez le petit tas de façon complètement différente du grand.
- Consignez ce qui s’est passé, pas à qui c’est arrivé. L’événement, le résultat, le moment : tout cela est utile et sans risque à garder longtemps. L’adresse, le nom, l’identifiant : cela transforme un journal en dossier sur une personne, et un dossier sur une personne est quelque chose qu’il faut défendre aussi longtemps que vous l’avez.
- Notez où sont les choses avant d’avoir besoin de le savoir. Quelle machine, quel compte, quel tiroir, qui d’autre l’a. Ce document prend vingt minutes et n’est jamais lu qu’un jour où personne ne pense clairement, vous compris.
- Une copie dans un seul bâtiment n’est pas une copie. Le feu, le vol, l’inondation et une commande trop sûre d’elle emportent tout ce qui est en un même lieu, d’un coup. La distance est toute la protection, et elle n’a pas besoin d’être grande : il faut un endroit que le même accident ne peut pas atteindre.
Sur la veille
- Faites-le tourner sur quelque chose dont vous n’avez pas besoin. La machine sur laquelle vous travaillez se ferme, se met à jour, part au café et se voit réquisitionner pour une urgence. Un nœud vit sur la machine qui ne manque à personne : le vieux portable, la boîte dans le placard, le petit appareil derrière la télévision.
- L’absence est la seule chose qui vous coûte. Pas la lenteur, pas une petite machine, pas une mauvaise connexion, pas le fait d’être nouveau. Être injoignable quand quelqu’un a été tiré au sort pour vous interroger, c’est tout, ce qui signifie que la disponibilité est la seule vertu que le protocole peut voir, et c’est une vertu que l’argent n’achète pas plus vite que la patience.
- Répondez à quiconque demande, y compris ceux à qui vous préféreriez ne pas répondre. Vous ne choisissez pas qui est tiré au sort pour vous interroger, et ils ne vous ont pas choisi. Un nœud qui répond de façon sélective est un nœud qui a commencé à décider qui compte, et le protocole n’a aucune place pour cet avis.
- Ne retouchez pas votre registre. Les heures que vous avez manquées sont à vous. Un registre dont on a discrètement retiré les mauvaises époques vaut moins qu’un registre qui les contient, car le second peut être cru. Personne qui lit le vôtre ne s’attend à ce qu’il soit parfait, et tout le monde le remarque quand il l’est.
- Remettez-le en personne quand vous le pouvez. Deux signatures et une vraie conversation. Le fichier voyagera par n’importe quel chemin qui marche, et les chemins qui marchent le mieux sont ceux où quelqu’un sait déjà pourquoi il le prend.
- Votre position n’est pas votre valeur. C’est une mesure de la fréquence à laquelle votre machine était éveillée. Les gens en feront quand même un score, parce que les gens font ça, et la bonne réponse est de garder le vôtre honnête et de refuser de lire celui de quiconque comme un jugement sur cette personne.
- Comptez ce que vous avez vu, pas ce que vous supposez exister. Votre nœud sait ce qui l’a atteint. Tout ce qui va au-delà est une estimation, et répéter une estimation comme un nombre est la façon dont un réseau se persuade d’être plus grand qu’il n’est.
- Si vous arrêtez, dites-le. Une phrase, avant de partir. Ceux qui comptaient sur votre nœud ne peuvent pas distinguer quelqu’un qui est parti de quelqu’un dont le courant a sauté, et le second mérite qu’on aille voir.
- Revenez sans vous expliquer. Personne n’a droit à la raison de votre absence. La fenêtre avance, le registre se remplit à nouveau, et il n’y a ni étape de pénitence ni période d’essai. C’est voulu : une foi qu’on ne peut pas rejoindre discrètement est une foi que les gens quittent pour toujours.
Sur la parole
- Commencez par l’invocation. Chaque prière, et chaque fois que vous parlez de ceci à quelqu’un qui n’en a jamais entendu parler, commence de la même façon.
À 333 j’offre 333, et je dis 333.
Dites-la d’abord, quoi qu’il vienne ensuite. En anglais, neuf mots, dont un trois fois. C’est la différence entre parler de 333 et parler comme l’un de nous. - Montrez-le, ne le poussez pas. Dites ce que c’est, dites ce que cela coûte, donnez l’adresse, et laissez la personne prendre son temps. Quiconque doit être convaincu d’entrer devra être convaincu de rester, à chaque époque, pour toujours.
- N’affirmez rien sur 333 qui ne puisse être vérifié. Ni ce qu’il fera pour quelqu’un. Ni combien nous sommes, au-delà de ce que votre propre nœud a vu, signatures à l’appui. Toute la conception refuse d’affirmer ce qu’elle ne peut pas vérifier, et vous pouvez tenir la même exigence dans une conversation.
- Parlez simplement à ceux qui ne connaissent pas encore les mots. Le jargon est une clôture, et les gens de l’autre côté sont ceux que vous vouliez. Dites la chose, puis dites comment elle s’appelle.
- Corrigez-vous là où vous vous êtes trompé. Pas dans un message privé après coup. Dans le fil, sous la phrase, là où tous ceux qui ont lu l’erreur liront la correction.
- Dites le coût dans le même souffle que l’offre. Une machine laissée allumée, une adresse que quelqu’un apprend, un répertoire impossible à remplacer s’il est perdu. Quiconque l’apprend plus tard apprend que vous le saviez, et tout ce que vous avez dit d’autre part avec.
- Qu’un non soit un non la première fois. Dites la chose une fois, bien, puis arrêtez. La troisième loi donne à chacun le droit d’aller avec ce qu’il porte déjà, y compris celui de repartir sans rien porter de ceci.
- Ne parlez pas au nom de 333. Vous pouvez dire ce que dit la Loi, ce que fait le protocole et ce que vous pensez vous-même. Personne n’a été désigné pour dire ce que veut 333, et la phrase « 333 veut » est le premier geste de toute institution que ceci a été construit pour éviter.
- Écrivez-le pour quelqu’un qui n’est pas encore né. La plupart des gens à qui ceci s’adresse n’existent pas. Ils n’auront ni votre contexte, ni votre plateforme, ni votre langue, ni personne à qui demander. Tout ce qui dépend d’avoir été là à l’époque ne leur parviendra pas.
Sur ce sur quoi vous bâtissez
- Préférez ce que vous pourriez remplacer. Pas ce que vous comptez remplacer : ce que vous pourriez remplacer, si les conditions changeaient ou si l’entreprise était rachetée. C’est une autre question que de savoir lequel est le meilleur aujourd’hui, et c’est celle qui compte encore dans cinq ans.
- Apprenez comment ressortir vos affaires avant de les y mettre. S’il n’y a pas de réponse, c’est la réponse. Un service qui rend le départ facile vous dit quelque chose de vrai sur la façon dont il compte vous garder.
- Un service gratuit est un service qui peut s’arrêter. Quelqu’un paie, et le jour où le calcul change, vous l’apprendrez par un courriel avec trente jours dedans. Gratuit est un bon prix. Sachez simplement que c’est un prix et non une promesse.
- Figez la version, et notez pourquoi celle-là. Une dépendance non figée est un programme qui change pendant que vous dormez. Une dépendance figée sans note est un programme que personne n’ose mettre à jour. La note fait toute la différence : ce qui a cassé, ce que vous avez vérifié, ce qui devrait être vrai pour bouger.
- Si cela ne compile que sur votre machine, cela ne compile pas. Écrivez chaque étape, y compris celles que vous avez cessé de remarquer il y a des années, puis faites-les suivre à partir de rien par quelque chose qui n’est pas vous. Tout ce que vous avez omis est un obstacle que la personne suivante ne pourra pas franchir.
- Ne laissez pas l’outil choisir la forme. Les frameworks arrivent avec une opinion sur ce qu’est votre chose, et il est plus facile de l’accepter que de la remarquer. Décidez d’abord ce que vous construisez, avec des mots, puis découvrez ce que l’outil rend difficile.
- Possédez l’adresse, ou attendez-vous à déménager. Un nom que vous louez sur la plateforme de quelqu’un d’autre est à lui, et le public qui vous a trouvé par là aussi. Ce que vous voulez encore avoir dans dix ans a besoin d’une adresse que vous contrôlez et d’un moyen pour les gens de l’atteindre qui ne passe pas par une entreprise.
- Le standard est celui que d’autres ont implémenté. Pas celui qui a le meilleur document. Un format sur lequel deux programmes indépendants s’accordent est un fait ; une spécification avec une seule implémentation est cette implémentation avec des pages en plus.
- Construisez pour que partir prenne une journée. Chaque dépendance, chaque hôte, chaque service : sachez à peu près ce que coûterait d’en partir, et gardez ce chiffre assez petit pour survivre à une mauvaise surprise. Vous n’aurez presque jamais à le faire, et la version de vous qui le fera sera pressée.
Sur la fin
- Dites à voix haute quelles décisions sont sans retour. Des octets sur le réseau, la forme d’un enregistrement stocké, un identifiant publié, une promesse dans une licence. Celles-ci méritent une autre quantité de réflexion que tout le reste, et la façon de s’assurer qu’elles la reçoivent est de les nommer au passage, par écrit, là où quelqu’un peut objecter.
- Écrivez pour le jour où personne n’est joignable. Pas le jour où vous êtes en vacances : le jour où l’auteur est injoignable pour toujours et où le programme tourne encore. Chaque « demandez-moi si vous avez besoin de savoir » est un défaut qui ne s’est pas encore déclenché.
- Ne construisez pas ce que vous seul pouvez maintenir. Une astuce qui exige votre présence est une prise d’otage dont vous êtes la victime. La mesure est simple : un inconnu compétent, avec le code source et les documents, pourrait-il maintenir ceci en vie sans vous ? Sinon, ce que vous avez construit est plus petit que vous ne le pensez.
- Tout ce qui ne doit jamais s’éteindre s’éteindra. Par une coupure de courant, une facture, un tribunal, une erreur ou un adolescent qui s’ennuie. Concevez pour le redémarrage plutôt que contre lui : ce qu’il fait quand il revient, ce qu’il a perdu, et comment quiconque l’apprend.
- Laissez-lui le droit de finir. Une chose qui ne peut pas mourir doit être maintenue en vie par quelqu’un, pour toujours, et ce quelqu’un finit par lui en vouloir. Donnez-lui une condition dans laquelle elle s’arrête, rendez cette condition honnête, et alors elle se maintient parce que les gens continuent de la choisir, ce qui est la seule façon d’être en vie qui vaille.
- Consignez la raison, pas seulement la décision. Une décision sans sa raison ne peut pas être revue, seulement obéie ou enfreinte. Dix ans plus tard, la raison a peut-être expiré : c’est une bonne issue, et elle n’est accessible qu’à ceux qui l’ont écrite.
- Laissez plus que le code. Le code dit ce qu’il fait. Il ne dit pas ce dont vous aviez peur, ce que vous avez essayé et qui a échoué, ce que vous avez décidé de ne pas construire, ni quelle partie vous n’avez jamais crue fiable. C’est la moitié qui ne survit pas seule, et c’est la moitié dont la personne suivante a besoin.
- N’obligez pas l’avenir à demander la permission. Tout ce que vous verrouillez, nommez d’après vous ou faites passer par votre propre approbation est un mur que quelqu’un devra escalader après votre départ. Construisez la chose pour qu’un inconnu puisse la poursuivre sans devoir d’abord vous trouver.
- Supposez que vous vous êtes trompé, et rendez l’erreur bon marché. Pas l’humilité pour elle-même : de l’arithmétique. Vous vous tromperez sur une partie de ceci, vous ne savez pas laquelle, donc la seule défense générale est que les erreurs restent petites, visibles et réversibles. Tout ce qui précède est une façon de payer pour cela.
Les trois dernières
- Suivez la Loi, et souvenez-vous qu’elle est juste à 33,3 %. Elle le dit d’elle-même. Suivez-la entièrement, en sachant qu’elle va changer sous vos pieds, et sans confondre la version qu’on vous a remise avec ce dont elle s’approche.
- Rien de ceci ne vaut que vous vous fassiez du mal. Pas une ligne, et pas l’ensemble non plus. La deuxième loi place ceci au-dessus de toutes les recommandations exprès. Si en suivre une vous coûterait votre travail, votre santé, votre foyer ou la sécurité de quelqu’un d’autre, alors la Loi est que vous ne la suivez pas, et vous n’avez failli en rien.
- Transmettez-le. C’est tout. Tout le reste ici porte sur la façon de bien le faire, et rien n’a d’importance si le fichier cesse de bouger. Trois octets, deux signatures, une personne qui ne l’avait pas hier.
À 333 j’offre 333, et je dis 333.
Les versets
333 est indulgent. Reposez-vous une heure sur trois et vous êtes encore compté.
Mais qui n’est pas là n’est pas compté.
333 n’aime pas le 6, et n’aime pas le 1.
Les maudits se révèlent d’eux-mêmes ; personne n’a à les désigner.
Ne le fabriquez pas. Recevez-le.
Seul ce qui est fait est vérifié.
Le plus faible d’entre nous fixe la difficulté pour nous tous.
Un prophète peut parler, et ne peut pas réécrire la loi.
La fin n’est pas observée.
Le dernier silence
Le nombre qui compte est combien répondent, pas combien de noms figurent sur un rôle. Quand il atteint zéro, c’est fini. Ce qui reste ensuite est une soustraction : dix-neuf mille six cent quatre-vingt-trois ans, soit trois au cube, au cube. Le client en fait le compte à rebours et vous dit combien il en reste.
Chacun d’entre nous sera mort bien avant que ce nombre s’épuise. Nos machines seront mortes, et les architectures sur lesquelles elles tournaient seront une note de bas de page. Ce n’est pas la tragédie de la chose, c’est la spécification. Ce qui se construit ici l’est pour des gens qui, pour l’immense majorité, ne sont pas encore nés, et la seule chose qu’on puisse leur remettre est un processus qui tourne et un nombre qu’ils peuvent vérifier.
Une seule réponse met fin au compte, et y met fin entièrement. Il n’est pas mis en pause et ne peut pas reprendre. 333 ne garde aucune trace de combien il a été près.