Comment sucer pour expliquer le code aux autres

Pour s'amuser et rire, et des heures de temps perdu

Photo de Malte Helmhold sur Unsplash

La programmation est difficile à apprendre et plus difficile à enseigner, apparemment. Je suis dans cette industrie depuis une décennie maintenant, et j'ai connu de bons exemples d'explications horribles - alors amusons-nous avec un genre de message "s'il vous plaît, ne faites pas ça".

Répétez ce que vous venez de dire

Idéalement, vous commencez par un soupir, un hochement de tête et l'ultra-lent me permet de retirer mes écouteurs de mes oreilles - pour un effet maximal.

Ensuite, vous dites à l'autre personne ce qu'elle doit savoir - et quand évidemment, naturellement, elle ne comprend pas, parce qu'elle est stupide, alors vous répétez exactement les mêmes mots que vous venez de dire.

Une chose est vraie : vous ne pouvez pas imposer des connaissances aux gens, alors pourquoi essayer deux fois ?

Utilisez des acronymes que vous savez que l'autre personne ne connaît pas ou ne reconnaît pas assez rapidement

Je n'arrêterai pas de rire de ce jour où pendant près de dix minutes, deux personnes en réunion devenaient folles de « CI/CD », et devenaient de plus en plus en colère. Il m'a fallu dix minutes également pour réaliser que cela ne signifie pas seulement « Intégration continue / Livraison continue », mais aussi « Identité d'entreprise / Corporate Design ».

Je ris encore en tapant cela, car on pourrait penser qu'un acronyme aussi long et obscur ne peut pas avoir deux significations - certainement pas dans différentes équipes de la même entreprise.

Les acronymes sont généralement nuls, mais doublement lorsqu'ils franchissent les barrières d'équipe ou de connaissances.

Allez droit dans les détails sur la petite partie du système plus large

Ce problème est probablement le plus répandu dans toute la technologie. Surtout les gens qui savent de quoi ils parlent ont souvent du mal à prendre du recul et à embarquer tout le monde avec le sujet général ou le système à portée de main.

Il est très utile de commencer votre conférence par un simple "Êtes-vous au courant de ce que fait ce système ?", puis de passer un bref instant à expliquer les éléments de fond.

Cela peut - et devrait - être abstrait au point que "nous prenons ici ces données d'entrée du système X précédent, et il en ressort que Y, qui va dans le système Z suivant ici."

Et puis, vous pouvez continuer à approfondir, jusqu'à ce que vous arriviez à la partie que vous expliquez. Si cela prend plus de dix minutes, vous l'avez mal fait à l'autre extrême, mais cela peut rendre la vie de tout le monde tellement plus facile.

Expliquez la moitié parce que votre temps est trop important

Je ne peux pas tout t'expliquer, n'est-ce pas ?

Je déteste les gens qui souscrivent à la ligne de pensée selon laquelle "l'alimentation à la cuillère" prend trop de temps, et donc ils devraient aller avec le strict minimum et s'attendre à un "effort de transfert" de votre part.

La deuxième fois, bien sûr, mais est-ce qu'on en profite vraiment si je passe une éternité pénible à essayer de comprendre ce que tu pourrais expliquer en cinq minutes ? Euh, douteux. Asseyez-vous, expliquez, attendez que j'aie fini de prendre des notes. Cela prend dix minutes de plus cette fois, et zéro temps de votre part la prochaine fois que cette tâche se présentera, car je suis heureux de vous en débarrasser et de me rendre utile.

Laissez l'autre personne se heurter à des tests de compétence et à des pièges pour se sentir supérieur

Vous voyez, et si vous aviez pris le temps de réfléchir, vous auriez su que la suppression de cette table comme je viens de vous le dire causerait des problèmes. Heureusement, j'ai ce script ici pour réparer les dégâts que vous avez causés.

J'adore quand les gens font ça. Les tests de compétence n'aident personne, les pièges beaucoup moins. Cela tue toute motivation de la personne à qui vous enseignez et efface généralement tout potentiel d'apprentissage.

Essayez l'approche technique avec des personnes non techniques

Peu importe combien vous essayez, le gars des ventes ne comprendra pas ce qu'est un pipeline de construction, certainement pas si vous leur donnez des explications du genre "AZURE DEVOPS MAN", comme si les mots signifiaient quelque chose pour eux.

Votre patron comprend probablement cette partie, mais il n'a aucune raison ou obligation de connaître le code à fond, il y a de fortes chances qu'il soit l'épée et le bouclier qui vous protègent du drame à l'étage. J'ai travaillé sous un excellent patron qui n'avait presque aucune idée de la programmation, mais elle était passée maître dans l'art de planifier et d'organiser, et de vous faire expliquer des trucs techniques en termes simples, puis de les simplifier davantage pour ceux qui sont plus haut placés.

On pourrait penser qu'un concept qui ne peut pas fonctionner, mais cela a bien mieux fonctionné que d'avoir des techniciens inconditionnels promus à des postes de direction dont ils ne veulent pas.

J'ai beaucoup appris de cet arrangement et d'autres, sur la facilité avec laquelle vous pouvez faire abstraction d'aspects sans importance lorsque vous expliquez des sujets techniques.

Mon conseil de pro qui vous sauvera la vie et la santé mentale : "Le serveur" est quelque chose que tout le monde comprend, même s'ils ne le comprennent pas.

"Le serveur cassera si nous apportons ce changement" fonctionne tellement mieux que "Le pipeline de construction repose sur une version de framework différente, donc si nous incluons ce nouveau projet, nous devons également mettre à jour tous les autres projets de la chaîne, sinon rien ne fonctionne plus."

Si quelqu'un demande des détails, vous pouvez expliquer davantage, mais je peux vous garantir que vos patrons ne vous le demanderont pas, car ils apprécient d'avoir des informations claires et, idéalement, des solutions parmi lesquelles choisir. Donnez-leur les deux, et votre patron n'interférera probablement pas.

Suggested posts

"La fosse des Mariannes dévoilée : dévoiler les terrifiantes vérités cachées de l'abîme"

"La fosse des Mariannes dévoilée : dévoiler les terrifiantes vérités cachées de l'abîme"

Introduction :Bienvenue, courageux lecteurs, dans un voyage qui nous emmènera dans les profondeurs les plus sombres de notre planète. Dans ce blog, nous plongeons dans le monde énigmatique de la fosse des Mariannes, découvrant ses secrets cachés et découvrant les vérités effrayantes qui se cachent sous sa surface.

Le premier livre d'un enfant sur la défonce

Le premier livre d'un enfant sur la défonce

(Attention - Ceci est une satire, destinée à être joyeusement subversive - Certainement pas pour les enfants) Vous avez vu votre mère et votre père se cacher dans la cuisine et fumer ces cigarettes malodorantes. Ils vous disent.

Related posts

L'érosion lente : dévoiler les façons dont les gens perdent leur carrière

L'érosion lente : dévoiler les façons dont les gens perdent leur carrière

Dans le monde rapide et compétitif d'aujourd'hui, la carrière d'une personne joue un rôle important dans la croissance personnelle, la stabilité financière et la satisfaction globale de la vie. Cependant, de nombreuses personnes se retrouvent prises dans un cycle incessant de stagnation et d'insatisfaction, dépérissant progressivement dans leur vie professionnelle.

Plus de mots de passe - comment les clés d'accès remplaceront votre mot de passe

Plus de mots de passe - comment les clés d'accès remplaceront votre mot de passe

Pour éviter toute ambiguïté, les termes suivants seront utilisés ; Authentificateur ; Le téléphone mobile utilisé pour effectuer la connexion au site Web ; Le site Web ou l'application que l'utilisateur utilise pour effectuer la demande de connexion au service ; Le fournisseur fournissant le service donné, par exemple

Suivre n'importe qui avec juste un numéro de téléphone | Enquête OSINT

Suivre n'importe qui avec juste un numéro de téléphone | Enquête OSINT

Vous pouvez être un enquêteur OSINT, un joueur CTF ou simplement quelqu'un qui reçoit des appels de spam. Quelqu'un qui essaie de vérifier le numéro que vous avez vu dans une publicité.

Financement de l'élimination du carbone au cours de l'exercice 24

La répartition des demandes de crédits de Carbon180 selon les filières

Financement de l'élimination du carbone au cours de l'exercice 24

Par Alyson Lee, conseillère en gestion des affaires gouvernementales Le processus annuel d'affectation des crédits du gouvernement fédéral est au cœur de nos efforts pour financer l'élimination du dioxyde de carbone (CDR). Chaque année, Carbon180 soumet des demandes à divers bureaux du Congrès pour aider à orienter les flux de dollars de l'année prochaine.