Pourquoi je n'utilise pas d'acronyme non documenté sur Wikipedia ?

#communication

Journal du lundi 11 juin 2018 à 10:20

Je viens d'ajouter le contenu du Mail de Musk en 2010 « Les acronymes sont vraiment à éviter » dans la documentation guidelines du projet professionnel sur lequel je suis en train de travailler actuellement.

Pourquoi ?

Dans un souci d'efficacité, j'aime recevoir des informations le plus explicites possible, afin d'éviter des quiproquos, de minimiser mes risques d'erreurs, d'éviter de faire perdre du temps à mes collaborateurs en posant une multitude de questions.

Comme j'essaie de suivre la règle d'or, j'essaie moi-même de communiquer de la façon la plus explicite possible — je précise que ce n'est pas simple, même avec la meilleure volonté du monde !

C'est pour cela que j'évite au maximum de créer et d'utiliser des acronymes.

Voici quelques extraits du Mail de Musk 2010 « Acronyms Seriously Suck ».

L'utilisation excessive d'acronymes inventés est un obstacle important à la communication et il est extrêmement important de maintenir une bonne communication au fur et à mesure que nous nous développons.

👍️

Personne ne peut se souvenir de tous ces acronymes et les gens ne veulent pas avoir l'air stupides lors d'une réunion, alors ils restent assis dans l'ignorance. C'est particulièrement difficile pour les nouveaux employés.

Je suis tout à fait d'accord avec cette déclaration 👍️.
J'ai appris par expérience que la majorité des humains ne posent pas de question quand ils ne connaissent pas un mot ou un sujet.
J'essaie personnellement de mettre mon égo de coté et de poser la question, mais il m'arrive aussi de ne pas le faire.

D'autre part, ma mémoire est limitée, l'apprentissage des acronymes internes d'une organisation ou d'une équipe me demande trop de charge cognitive.

Un acronyme que la plupart des ingénieurs en dehors de SpaceX connaissent déjà, tel que GUI, peut être utilisé.

Je suis tout à fait aligné avec cette pratique👍️.

Personnellement, je suis la règle suivante : j'ai le droit d'utiliser un acronyme à condition qu'il soit référencé par une page Wikipedia et que la liste de ses homonymes sur sa page "disambiguation" soit très courte dans mon contexte d'utilisation (exemple pour FTP). Si ce n'est pas le cas, je n'utilise pas l'acronyme.

Journaux liées à cette note :

J'aime être explicite, j'évite l'utilisation des acronymes, j'essaie de désigner les ressources (lien vers un paragraphe, une fonction, une issue, un contrat, un client…) avec des URLs, afin d'éviter toute ambiguïté.

J'ai de plus en plus l'intuition que l'usage d'un Organisation knowledge management combiné à de multiples Personal knowledge management de type Obsidian, SilverBullet.mb sont très utiles dans un contexte de travail en équipe et dans une organisation.

Partant de cette préférence et de cette intuition, j'ai eu une idée, j'ai ressenti un besoin que je vais expliquer dans cette note.

Je suis en train de rédiger une issue dans GitHub.
Dans la description de l'issue, je souhaite faire mention de la notion de PII et d'un champ de base de données.

J'aimerais développer une extension navigateur qui permet de saisir des wikilink ([[PageName|custom title]]) dans les zones de texte supportant de Markdown de GitHub, GitLab, Trello, Mattermost, Zullip, etc, avec le support de la recherche / autocomplétion.

J'aimerais ajouter une fonctionnalité qui affiche, lors du survol d'un wikilink, un popup contenant un aperçu de la page liée. Cela permet, par exemple, de consulter rapidement la signification d'un acronyme ou d'identifier une ressource.

J'aimerais que cette extension puisse être connecté à un ou plusieurs knowledge management system.