J’ai parlé d’un moyen simple de documenter vos projets en prenant beaucoup de photos, et des façons dont vos PCB pourraient se documenter eux-mêmes. Aujourd’hui, parlons d’un moyen rapide et facile d’aider d’autres pirates au cours de vos propres aventures de piratage — en laissant des miettes de pain.
En bref, les fils d’Ariane sont de petites informations cruciales que vous avez dû passer du temps à comprendre. Ce sont des solutions à des problèmes qu’un autre hacker comme vous pourrait rencontrer à l’avenir, quelque chose que vous souhaiteriez peut-être ne pas avoir à résoudre par vous-même, et certainement quelque chose que d’autres n’auront pas besoin de passer du temps à comprendre.
Les fils d’Ariane permettent de gagner du temps, pour vous et les autres. Cela aide si vous pensez à vos problèmes résolus en termes de temps passé. Si vous trouvez un petit problème et que vous publiez ensuite votre solution, vous gagnerez peut-être une demi-heure, une heure complète ou quelques bonnes heures de temps à un autre pirate informatique qui pourrait même être moins expérimenté que vous en matière de débogage. En fait, votre fil d’Ariane pourrait même faire la différence entre quelqu’un qui termine un projet et l’abandonne !
Cependant, il y a aussi le compromis de prendre du temps pour documenter quelque chose. Si vous ne pouvez pas publier votre solution en quelques minutes, il pourrait devenir beaucoup plus difficile de persuader votre cerveau de publier la prochaine fois que vous aurez quelque chose de notable. Voici une ligne directrice : si vous venez de trouver une commande de terminal sympa qui vous aide à résoudre un certain type de problème, vous devriez avoir un moyen rapide de publier cette commande en une minute. La bonne nouvelle, c’est qu’Internet propose une centaine d’endroits différents où vous pouvez facilement partager vos découvertes, selon le type de problème que vous avez résolu !
Auto-édition pour les pirates
Il est extrêmement important que vous réduisiez au minimum le temps nécessaire pour publier quelque chose. Ne pensez pas que vous devez commencer tout de suite un blog fantaisiste pour publier cette seule note, il suffit de créer un compte wordpress.com ou un nouveau référentiel GitHub. GitHub a spécifiquement la plate-forme Gist qui est bonne pour les notes courtes, mais vous pouvez également créer un référentiel appelé « notes » qui contient un tas de fichiers Markdown avec des noms de fichiers descriptifs. En fait, avoir un référentiel GitHub avec des fichiers de démarquage est assez proche d’avoir un blog décent, avec beaucoup moins d’efforts de configuration pour démarrer. Consultez ce référentiel pour un excellent exemple !
Vous n’avez pas besoin d’un plugin de section de commentaires, vous n’avez pas besoin d’analyses ou de plugins sophistiqués, vous n’avez même pas besoin de votre propre hébergement, vous n’avez besoin que d’un espace pour le texte et d’un peu de possibilité de recherche. Tout ce dont vous avez réellement besoin, c’est d’un endroit pour poster des choses rapidement. Vous ne voudriez pas rendre votre fil d’Ariane difficile à quitter, cela devrait prendre le moins de temps possible. Avoir votre éditeur de texte préféré ouvert et prêt aide certainement, vous pouvez donc être à 5 à 10 secondes de copier-coller vos notes dans un document publiable. Un référentiel GitHub correspond à ce projet de loi, tout comme un blog WordPress ou même une page de pile Hackaday.io.
Lorsque vous choisissez le texte à mettre dans votre message, il vaut la peine d’envisager un peu d’optimisation pour les moteurs de recherche (SEO), qui dans notre cas se résume à « qu’est-ce qu’un autre pirate informatique pourrait rechercher en essayant de résoudre ce problème ? » Donc, intégrez tous les mots-clés et chaînes spécifiques et généraux que vous avez vous-même recherchés dans le moteur de recherche, obtenez le nom du message d’erreur spécifique si vous l’avez toujours et, si votre blog prend en charge les balises, ajoutez toutes les balises qui semblent comme ils s’appliquent bien. Vous voudrez faire en sorte que d’autres puissent trouver ce message lorsqu’ils ont spécifiquement besoin de votre aide !
Ne vous attendez pas à des commentaires ou des likes, ou à des commentaires en dehors d’un compteur de vues. Ma page de statistiques WordPress n’affiche pas beaucoup de vues sur mon fil d’Ariane, la moitié d’entre elles sont dans la plage de 50 à 100 vues à vie et 40 % dans la plage de 100 à 1000 vues. Cependant, même si 99 % de ces vues sont des robots, cela reste un nombre décent de personnes résolvant un problème similaire dans l’ensemble. Si vous parvenez à aider quelqu’un à économiser une ou deux heures de travail de débogage, c’est une grande victoire.
Avoir votre propre blog avec du fil d’Ariane peut certainement vous aider à bâtir votre propre réputation, et il a aussi une grande valeur sentimentale. Par exemple, je me sens bien quand je fais défiler mon ancien blog de fil d’Ariane de nos jours ; il a solution après solution, chaque message ayant probablement aidé quelqu’un d’autre en cours de route, et chaque message me ramène à un projet sur lequel je travaillais. Peut-être que je piratais juste quelque chose d’intéressant pendant mon temps libre, ou peut-être que j’aidais un ami, mais dans tous les cas, c’est un bon rappel du « oh, j’ai résolu ce problème une fois! » type.
Pourtant, avec votre propre blog, il y a des inconvénients. Par exemple, contrairement aux pages de forum, vous n’avez plus l’avantage SEO d’autres personnes ayant déjà cliqué sur le résultat de la recherche. Et si vous voulez maximiser les chances que la réponse soit trouvée ? Et si vous n’avez pas encore de blog et que vous n’arrivez pas à franchir la barrière du perfectionnisme ?
Aller à la source
Nous connaissons tous l’histoire – vous trouvez un fil de discussion où quelqu’un a exactement le même problème que vous, et le dernier message est « Je l’ai résolu moi-même », aucune solution en vue. C’est frustrant à voir, et si vous recherchez un peu de confort, laisser des miettes de pain vous aide à déplacer le monde dans la direction opposée.
Parmi des milliers de plates-formes mortes, vous verrez absolument StackOverflow prêt à vous aider sans aucune condition, Reddit avec sa communauté récemment déchirée, Blogger sur le point de perdre toute sa collection d’images, et les quelques forums encore opérationnels. Pourtant, toutes ces plateformes ont leur place dans les moteurs de recherche, même si les premières pages ont été livrées au spam généré par l’IA. Parfois, les comptes et les discussions seront supprimés, les images liées disparaîtront, les anciens messages pourraient être verrouillés, un fléau sur les forums et Reddit si vous voulez juste laisser un fil d’Ariane. Cependant, vous vous retrouverez toujours sur leurs pages, et d’autres aussi.
Au fur et à mesure que vous résolviez votre problème, vous l’avez probablement recherché sur Google de différentes manières. Vous pouvez avoir plusieurs types d’onglets de navigateur : problèmes GitHub, pages StackOverflow, fils de discussion, messages de blog d’autres personnes, peut-être même une discussion publique que vous avez vous-même lancée entre-temps. Tous ces éléments sont d’excellents endroits pour publier une réponse – tant qu’il s’agit d’une page que vous avez trouvée via un moteur de recherche, le même moteur de recherche est plus susceptible de diriger les internautes vers la seule information cruciale que vous avez trouvée.
Des sites Web comme StackOverflow reconnaissent également le concept de fil d’Ariane. Vous pouvez y poser une question, mais vous pouvez également poser votre propre question et y répondre, et vous pouvez même poser une question spécifiquement dans le but de donner votre propre réponse en dessous ! N’oubliez pas que StackOverflow a une section électronique ! Vous êtes probablement déjà tombé dessus, mais si ce n’est pas le cas, le voici.
StackOverflow et Reddit partagent un problème : ils ont des exigences minimales pour leurs publications, et vous ne les rencontrerez peut-être pas nécessairement. Si votre problème tombe sous le coup d’une sorte de ligne directrice de la tragédie des biens communs, ou si votre question est perçue comme trop similaire à quelqu’un malgré des nuances vitales, elle pourrait être fermée et rétrogradée. Cela dit, mes quelques réponses StackOverflow ont certainement aidé les autres au fil du temps. Une fois, j’ai résolu un petit problème en 2018, je l’ai posté comme réponse, et à ce jour, je reçois toujours des notifications de vote positif pour la solution que j’ai publiée. Je ne peux pas le nier, cela seul me réchauffe le cœur !
Publier ou périr
Peu importe où vous laissez la chapelure, il importe autant que vous les laissiez quelque part. Surtout, il devrait être facile pour vous de les quitter. La possibilité de recherche aide, et si vous pouvez optimiser pour cela, faites-le. Ne laissez peut-être pas votre fil d’Ariane sur X (anciennement Twitter), ou à tout endroit que vous ne voyez pas souvent dans les résultats de recherche. À moins qu’il ne s’agisse de votre blog, auquel cas vous arriverez sûrement bientôt sur Google !
Même un petit fil d’Ariane peut orienter un collègue hacker dans la bonne direction – et ne souhaiteriez-vous pas en avoir un sous la main avant de vous lancer dans un voyage de débogage de trois heures ?
