La page « Read me »

1. La demande de Karl, dans ses mots

« Dans le tiroir du compte, en haut à droite, plutôt que Help, il devrait peut-être y avoir à la place une section Read me. Et quand on clique dessus, ça mène à une page qui contient toutes les informations pertinentes à savoir par rapport au fonctionnement d'ASA Compass. »

Deux gestes, donc. Remplacer l'entrée « Help » du menu de profil par « Read me », et bâtir derrière elle une vraie page de référence, celle qu'un visiteur lit une fois pour comprendre ce qu'est le site, ce qu'il peut y faire et ce qu'il lui en coûte.

2. La recherche à faire avant d'écrire une ligne

Cette page va décrire des mécanismes qui existent déjà et des chiffres qui bougent. La règle du projet vaut ici plus qu'ailleurs : relever, ne pas se souvenir. Voici où chaque chose se lit.

3. Renommer l'entrée du tiroir et choisir l'adresse

4. Le plan de la page, section par section

Onze sections, dans cet ordre. L'ordre n'est pas décoratif : il va du plus urgent pour un nouveau venu au plus technique. Les titres sont proposés en anglais, la langue du site.

1. What this is (ce que c'est)

Trois phrases, pas plus. Des dizaines de milliers de NFT ont été frappés sur Algorand en 2021 et 2022 par des créateurs isolés. Les places de marché n'ont référencé que les collections promues, et presque toutes ont fermé depuis. ASA Compass reconstitue le reste directement depuis la chaîne.

2. What you can do today, and what you cannot

La section la plus importante, et elle doit être en haut. Aujourd'hui : parcourir, chercher, voir ce que son portefeuille détient. Pas encore : acheter, vendre, offrir. Dire pourquoi, franchement : le contrat de règlement attend d'être relu par quelqu'un d'autre que son auteur. Cette phrase-là inspire plus confiance qu'une promesse.

3. How the catalogue is built

Ce qui explique tous les défauts que le visiteur va rencontrer. L'indexation lit la chaîne, regroupe les pièces en séries par leur nom, leurs métadonnées et leur façon d'avoir été frappées, puis note chaque créateur. Ce qui est publié est ce qui dépasse un seuil de qualité. Donc : des collections manquent, certaines sont mal regroupées, et cela se corrige quand on le signale.

4. Your wallet, and what connecting does

Connecter ne fait que lire des données publiques. Aucune clé, aucune phrase de récupération n'atteint le site. Toute signature se fait dans le portefeuille, et rien ne part sans approbation explicite. Dire aussi quels portefeuilles fonctionnent aujourd'hui, et lesquels arrivent, la question du matériel étant vive pour qui garde des pièces depuis 2021.

5. What it costs on Algorand

La section que personne n'écrit et que tout le monde cherche. Trois coûts, distincts et à ne pas confondre : les frais de réseau, minuscules et définitifs ; la réserve immobilisée par actif accepté, qui n'est pas dépensée mais bloquée tant qu'on garde l'actif ; le dépôt d'une mise en vente, qui revient entièrement à la fermeture de l'annonce. Un tableau vaut mieux qu'un paragraphe.

6. How selling will work

Le mécanisme d'entiercement, expliqué sans jargon : la pièce est confiée à un coffre gouverné par du code sans clé, qui ne la rend qu'au bon acheteur contre le bon paiement, ou au vendeur s'il annule. Puis la commission, le prix plancher et plafond, la durée d'une annonce, la taille maximale d'un lot.

7. Offers and auctions

Comment offrir sur une pièce qui n'est pas en vente, ce qui est le mécanisme d'amorçage du site, et ce qu'il advient de l'argent pendant qu'une offre attend. Même chose pour les enchères : la mise, la réserve, la prolongation quand une mise tombe à la dernière minute.

8. Paying with XDB (bloc composé, prêt à poser)

Karl a demandé que ce bloc soit rédigé plutôt que décrit. Le voici, en anglais comme le reste du site. Les crochets marquent les deux endroits qui dépendent de décisions encore ouvertes.

Pourquoi le bloc est écrit ainsi

• La divulgation vient en deuxième, avant l'avantage. Le jeton appartient à ceux qui tiennent le site : le dire soi-même, tôt, et sans détour, est ce qui protège la crédibilité du reste de la page. Découvert par un visiteur, le même fait devient un soupçon.
• Le coût est annoncé avant le bénéfice d'usage. Les 0,1 ALGO immobilisés et l'ALGO nécessaire aux frais sont les deux choses qui surprennent, donc elles se disent avant, jamais après.
• La liquidité doit être décrite honnêtement. Un jeton qu'on ne peut pas revendre sans faire bouger son propre prix est un jeton mince, et le lecteur le découvrira de toute façon en essayant.
• Le dernier paragraphe est une recommandation, pas une obligation. Karl peut l'écarter. Mais un site qui garde de l'argent en entiercement et qui accepte le jeton de son propre exploitant a tout intérêt à écrire noir sur blanc qu'il ne promet aucune valeur.

9. Names, images and why some are missing

Les noms affichés viennent des NFD. Les images vivent sur IPFS, réseau où un fichier disparaît si plus personne ne le conserve, ce qui explique les vignettes absentes. Dire ce que le site fait pour y remédier.

10. Claiming your collection

Pour les créateurs : prouver qu'on est l'auteur en se connectant avec le portefeuille qui a frappé la série, et reprendre la main sur la présentation de sa page. Section à écrire quand la fonctionnalité existera, à prévoir dans le plan dès maintenant.

11. Reporting a problem

Un regroupement faux, une collection manquante, une image morte. Dire où écrire et ce qui aide à corriger vite : l'identifiant de l'actif ou l'adresse du créateur.

Glossaire

En bas, court, pour ne pas alourdir le reste : ASA, NFT, opt-in, IPFS, NFD, ARC-69, testnet, entiercement. Chaque terme en une phrase, avec le mot anglais utilisé sur le site.

5. Les faits vérifiés à y mettre

Relevés dans les sources du projet le 31 août 2026. À revérifier avant publication, puisque plusieurs bougent.

6. La forme

• Une seule page longue, avec un sommaire ancré en tête. Onze sections réparties sur onze pages obligeraient à chercher, ce qui est exactement ce que la page vise à supprimer.
• Reprendre la fabrique des pages de service déjà en place dans le générateur, celle qui produit Help, Contact et Settings. Ne pas inventer un gabarit de plus.
• Le sommaire suit la lecture sur grand écran, comme la chronologie de l'accueil marque le mois où l'on se trouve. Le mécanisme existe déjà, il se réutilise.
• Sur téléphone, le sommaire se replie en un bloc dépliable en tête de page plutôt que de manger un écran entier. Vérifier à 375 points de large, la taille sur laquelle Karl regarde.
• Les tableaux de coûts défilent horizontalement dans leur propre cadre : le corps de la page ne doit jamais défiler de côté.
• Aucun tiret cadratin, comme partout ailleurs sur le site. Le contrôle est passé sur les 734 pages, il ne faut pas le rouvrir.

7. Ce qu'il ne faut surtout pas écrire

8. Les vérifications avant publication