les gars, lisez-le @Dusk
Publier
Mr_Badshah77
·
--
#dusk $DUSK @Dusk ......J’ai l’habitude de regarder le code des protocoles pour les grandes choses. Cette fois-ci, une petite modification de la documentation a retenu mon attention.
Dusk a modifié la façon dont ses docs valident et publient le sitemap.
Au premier abord, on dirait de l’entretien :
« npm run build » est passé d’une simple étape de build à un flux de vérification qui construit le site, exécute les tests, puis vérifie le résultat.
Mais le changement le plus intéressant concerne ce qui se passe pour sitemap.xml.
Au lieu de maintenir un sitemap statique séparé, la build utilise désormais le sitemap-index.xml généré par Astro et crée le sitemap.xml conventionnel comme un alias.
Ça a l’air ennuyeux.
En réalité, cela corrige un problème d’infrastructure utile.
Imaginez comme si vous changiez le système d’adressage d’un bâtiment. Le bâtiment génère déjà la bonne carte interne, mais les visiteurs externes s’attendent toujours à trouver l’entrée à une adresse familière. Plutôt que de maintenir deux cartes qui peuvent diverger, la build crée l’adresse familière à partir de la source générée.
Les tests renforcent cette idée.
#Dusk vérifie désormais que le sitemap généré est valide et que le sitemap.xml conventionnel le reflète exactement. Donc une modification de la documentation peut faire échouer la vérification si ce lien se brise.
Ce que j’aime ici, c’est l’approche « ingénierie ».
Le commit n’ajoute pas une fonctionnalité de protocole tape-à-l’œil. Il réduit simplement le risque que l’infrastructure de documentation devienne silencieusement incohérente à mesure que le site évolue.
Et c’est plus important que ce que ça en a l’air.
Pour un projet technique, la documentation fait partie de l’interface sur laquelle comptent les développeurs, les opérateurs et les outils automatisés.
Un lien cassé, un sitemap obsolète ou une build incomplète ne compromettent pas le consensus, mais peuvent quand même créer des frictions autour de tout ce qui s’appuie sur le protocole.
Petit commit. Problème très peu glamour.
Mais ce sont souvent les détails qui me disent à quel point une équipe prend au sérieux l’infrastructure qui entoure le produit principal.
C’est la partie que j’ai trouvée intéressante dans ce changement de Dusk.
$ACE $RED #ChinaJulyOutputRetailInvestmentAllMiss #CMESeptemberHikeOddsFallTo30.6% #CryptoStartupsRaise$11.2BInH1 #EthereumFoundationLaunchesGlamsterdamTestnet
Dusk a modifié la façon dont ses docs valident et publient le sitemap.
Au premier abord, on dirait de l’entretien :
« npm run build » est passé d’une simple étape de build à un flux de vérification qui construit le site, exécute les tests, puis vérifie le résultat.
Mais le changement le plus intéressant concerne ce qui se passe pour sitemap.xml.
Au lieu de maintenir un sitemap statique séparé, la build utilise désormais le sitemap-index.xml généré par Astro et crée le sitemap.xml conventionnel comme un alias.
Ça a l’air ennuyeux.
En réalité, cela corrige un problème d’infrastructure utile.
Imaginez comme si vous changiez le système d’adressage d’un bâtiment. Le bâtiment génère déjà la bonne carte interne, mais les visiteurs externes s’attendent toujours à trouver l’entrée à une adresse familière. Plutôt que de maintenir deux cartes qui peuvent diverger, la build crée l’adresse familière à partir de la source générée.
Les tests renforcent cette idée.
#Dusk vérifie désormais que le sitemap généré est valide et que le sitemap.xml conventionnel le reflète exactement. Donc une modification de la documentation peut faire échouer la vérification si ce lien se brise.
Ce que j’aime ici, c’est l’approche « ingénierie ».
Le commit n’ajoute pas une fonctionnalité de protocole tape-à-l’œil. Il réduit simplement le risque que l’infrastructure de documentation devienne silencieusement incohérente à mesure que le site évolue.
Et c’est plus important que ce que ça en a l’air.
Pour un projet technique, la documentation fait partie de l’interface sur laquelle comptent les développeurs, les opérateurs et les outils automatisés.
Un lien cassé, un sitemap obsolète ou une build incomplète ne compromettent pas le consensus, mais peuvent quand même créer des frictions autour de tout ce qui s’appuie sur le protocole.
Petit commit. Problème très peu glamour.
Mais ce sont souvent les détails qui me disent à quel point une équipe prend au sérieux l’infrastructure qui entoure le produit principal.
C’est la partie que j’ai trouvée intéressante dans ce changement de Dusk.
$ACE $RED #ChinaJulyOutputRetailInvestmentAllMiss #CMESeptemberHikeOddsFallTo30.6% #CryptoStartupsRaise$11.2BInH1 #EthereumFoundationLaunchesGlamsterdamTestnet
Avertissement : ce contenu inclut des opinions de tiers. Il ne constitue pas un conseil. Binance Ai peut être utilisée, sans garantie de résultat. Consultez les CG.