work in progress
La référence 2 min Principe Portée : à adapter à ton périmètre

Une trace n'est pas forcément du code

Le réflexe

Tu voudrais transmettre une pratique, mais les exemples de bibliothèques ou de code public te semblent éloignés de ton métier ou de ton expérience.

Le réflexe builder

Pars de la personne à aider et de ce qu’elle doit comprendre ou faire. Choisis une forme adaptée à ce besoin, technique ou non.

Pourquoi

Une trace peut être une fiche, une explication, une décision commentée, un schéma, une démonstration enregistrée avec accord ou un exemple de travail. Elle peut servir dans une équipe, une association ou au-delà. Un dépôt privé peut être utile à ses destinataires, tout comme une page publique peut ne répondre à aucun besoin réel.

Une personne aux opérations prépare une fiche pour accueillir un intervenant. Elle explique les informations à vérifier, un cas qui demande de l’aide et le contact à prévenir. Un pair l’essaie puis signale une ambiguïté. La fiche devient plus utile sans contenir de code, de chiffre original ou de découverte inédite.

Les métiers ont leurs façons de transmettre. En finance, un exemple de calcul avec ses hypothèses ; au support, un cas commenté ; en design, un parcours avec ses raisons ; dans une activité bénévole, une liste de préparation. Les observations qualitatives comptent aussi. La valeur dépend de l’aide apportée et de la justesse du contexte, pas d’une obligation de quantifier.

Il n’est pas nécessaire d’être la première personne à expliquer une méthode. Une adaptation, une traduction ou un exemple accessible peut aider un nouveau destinataire, en reconnaissant ce qui vient d’ailleurs. Une personne qui débute peut conserver ce qui l’a aidée et faire vérifier ses explications. Une personne expérimentée peut préciser les exceptions et les limites, plutôt que chercher une originalité forcée.

À essayer

Choisis une question qu’une personne rencontre réellement. Propose une petite ressource qui y répond, avec un exemple et ce qui reste hors de son périmètre.

Utilise des informations autorisées ou un cas construit clairement annoncé. Ne copie pas un dossier réel seulement pour rendre le support concret. Convenez du temps de préparation et du lieu où la personne pourra le retrouver.

Fais essayer ou relire le support. Note ce qui a été compris, ce qui manque et qui pourra le corriger si la pratique change. Tu peux garder une forme interne ou accompagnée si elle répond mieux au besoin.

Depuis ton siège

À discuter

Quelle forme aiderait le prochain destinataire de notre savoir, même sans code ni mesure originale ?

En discuter