Comment poser correctement des questions si vous êtes un informaticien novice

Salut!

Au cours des deux dernières années, j'ai beaucoup travaillé avec des personnes qui débutent tout juste leur carrière dans l'informatique. Étant donné que les questions elles-mêmes et la manière dont de nombreuses personnes les posent sont similaires, j'ai décidé de rassembler mon expérience et mes recommandations en un seul endroit.

Il y a longtemps, j'ai lu статью 2004 par Eric Raymond, et l'a toujours suivi à la lettre dans sa carrière. Il est assez volumineux et s’adresse davantage aux administrateurs système. Je dois aider des gens, qui n'ont souvent aucune expérience en matière de développement, à devenir juniors et à démarrer leur carrière.

Pour ceux qui sont déjà devenus, ou rêvent encore de devenir développeur novice, je peux donner les recommandations suivantes :

  • Étudiez le problème vous-même
  • Communiquez d’abord l’objectif, puis exposez le problème.
  • Écrivez avec compétence et précision
  • Posez des questions à l'adresse et partagez la solution
  • Respecter le temps des autres
  • Regarder plus large

Et maintenant pour plus de détails.

Étudiez le problème vous-même

Vous apprenez un langage de programmation à partir d’un livre ou d’un cours. Nous avons pris un exemple de code, l'avons exécuté, mais il s'est écrasé avec une erreur qui n'était pas claire pour vous. D'après le livre, cela devrait fonctionner. Mais vous en croyez vos yeux, ça ne marche pas. Quelles sont les options?

  • Décidez que vous ne deviendrez jamais développeur parce que le monde entier est contre vous et que même les exemples concrets ne fonctionnent pas. Arrêtez d’étudier ;
  • Décidez que vous ne deviendrez jamais développeur parce que vous êtes trop stupide ou que vous ne l'avez pas. Arrêtez d’étudier ;
  • Commencez à demander à tous ceux que vous connaissez qui sont au moins d’une manière ou d’une autre connectés à l’informatique, en exigeant qu’ils comprennent pourquoi cela ne fonctionne pas pour vous. Découvrez beaucoup de nouvelles choses sur vous-même, soyez offensé. Arrêtez d’étudier ;

Quelle option est correcte ? Il est la:

Comprenez que vous n'êtes pas unique (peu importe ce que disent votre mère et votre grand-mère) et que le monde informatique n'est pas aussi simple qu'ils le prétendent lorsqu'ils vous invitent à des cours et des webinaires.

Comprendre que vous n’êtes pas unique conduit à réaliser que votre problème a probablement déjà été rencontré par des dizaines, des centaines, des milliers de personnes. Si vous êtes un développeur novice, vous pourriez facilement ne pas remarquer, installer ou configurer quelque chose. Voici une liste de contrôle que je vous suggère de parcourir avant de réaliser que vous ne pouvez pas résoudre le problème par vous-même et que vous avez besoin d'aide :

  • Assurez-vous que la question est unique et qu'il n'y a pas de réponse sur Internet
  • Étudiez attentivement la cause du problème, pas son effet
  • Évaluer les solutions possibles au problème, leurs avantages et leurs inconvénients
  • Réfléchissez à des options alternatives pour atteindre votre objectif
  • Réfléchissez à ce qu’on pourrait vous demander et préparez vos réponses à l’avance.

С première Le fait est que tout est trivial : si le texte de l'erreur vous est totalement incompréhensible, copiez-le dans Google et lisez attentivement le texte des liens.

Deuxième: par exemple, si votre code plante avec l'erreur « Je ne parviens pas à connecter une bibliothèque tierce », alors le problème ne vient pas de votre code. Le fait est que vous n’avez pas installé la bibliothèque que vous souhaitez utiliser. Cela signifie que vous devez chercher comment l'installer, et non comment corriger votre code.

troisième и le quatrième assez similaire : que se passe-t-il si cette bibliothèque est le problème et que j'ai juste besoin d'en chercher une autre ? Que se passe-t-il si je n'utilise pas du tout de bibliothèque tierce, mais que j'écris mon propre code à l'aide d'outils standards ?

Quinte Ce point nous amène à la partie suivante : réfléchissez à ce que la personne que vous approchez pourrait vous demander et préparez les réponses.

Communiquez d’abord l’objectif, puis exposez le problème.

Le but est ce que vous vouliez faire. Par exemple, écrivez un code qui va sur Internet et enregistre 10 images avec des chats amusants. Le problème est pourquoi vous voyez une erreur dans la console, mais vous ne voyez pas 10 chats amusants. Ne commencez pas votre question par un problème. Commencez par un objectif, terminez par un problème. Si la personne à qui vous demandez de l'aide est un développeur expérimenté et en sait beaucoup, elle sera probablement en mesure de vous proposer une solution plus simple et plus élégante au problème. Si vous avez déjà choisi le plus simple et le plus élégant, il comprendra clairement quoi et pourquoi vous voulez faire, ce qui accélérera la réception d'une réponse.

Bonne question:

Je veux sauver 10 chats rigolos chaque jour pour rire et prolonger ma vie. Pour ce faire, j'ai écrit le code suivant : […]. Je m'attends à ce qu'il se connecte à un serveur FTP et télécharge de nouvelles images à partir de là. Cependant, lorsque je l'ai lancé, j'ai vu cette erreur : […] Bien que je puisse accéder à ce serveur via le navigateur.

Réponse rapide:

Vous n'auriez pas dû prendre cette bibliothèque ; personne ne la supporte ou ne la développe depuis longtemps. Mieux vaut prendre celui-ci - je télécharge moi-même des photos avec des chats !

Mauvaise question :

Bonjour, mon code a produit l'erreur suivante […], savez-vous ce qui ne va pas ?

La réponse évidente :

Bonjour. Non je ne sais pas.

Écrivez avec compétence et précision

Il n’est pas nécessaire de déverser un flot de pensées sur une personne. La personne vers laquelle vous vous êtes tourné pour résoudre le problème est occupée par ses propres affaires. Assurez-vous qu’il comprenne rapidement quel est votre problème et ce que vous attendez de lui. Si vous avez des problèmes d'alphabétisation, utilisez les services de vérification d'orthographe et de ponctuation en ligne. Vous pouvez supprimer les courriers indésirables des messages sans services en ligne. Ne versez pas d'eau, ne partez pas de loin. Écrivez brièvement, succinctement et précis. Donnez des exemples.

Mal:

- salut, comment ça s'est passé))) J'essaie de monter un projet en bref, mais ça ne marche pas pour moi, ça plante pour une raison quelconque O_o, même s'il semble que j'ai tout fait correctement, s'il te plaît viens) )))) il y a en fait quelque chose d'incompréhensible pour moi dans la console ((( déjà c'est vrai j'ai tout essayé, rien ne marche, ahhh(

Bon:

— Bonjour, j'essaye de démarrer un projet, mais il y a un problème. Il plante immédiatement après la commande docker-compose up, voici le journal de démarrage et l'erreur : […] Pouvez-vous me dire comment le résoudre ?

Posez des questions à l'adresse et partagez la solution

Vous ne devez pas écrire de question dans un message personnel adressé à une personne spécifique, à moins que vous n'ayez été informé que vous deviez lui poser spécifiquement. Il est préférable d'écrire à un groupe de personnes car :

  • Chacun est occupé à résoudre ses propres problèmes. Les chances que quelqu'un dans une discussion générale ou sur un forum puisse vous consacrer du temps sont plus élevées.
  • Les chances que quelqu'un dans le chat général sache comment vous aider sont plus élevées.
  • Vous laissez aux autres le soin de trouver la même question et la même réponse plus tard.

Jetez un œil au dernier point. Avez-vous déjà appris que vous devriez essayer de résoudre les problèmes vous-même ? Avez-vous déjà utilisé la recherche par chat/forum/groupe, mais n'avez trouvé aucune mention de votre problème ? D'accord, alors demandez.

D’un autre côté, il n’est pas nécessaire de déranger inutilement les gens. Si possible, supprimez de votre liste de diffusion toute personne qui ne peut pas vous aider. Plus une personne reçoit de messages, moins elle a de chances de tous les lire. Ne donnez pas aux gens l’habitude de désactiver les alertes ou simplement d’ignorer les messages.

Votre expérience peut sûrement être utile à quelqu’un d’autre. Gagnez du temps pour vous-même et pour les autres en publiant une réponse ou une solution. Le prochain nouveau venu, s'il sait déjà de quoi nous parlons ici, ne dérangera personne du tout - il trouvera votre solution en cherchant. Pourquoi je dis que vous pouvez gagner du temps ? Parce que vous pourriez rencontrer ce problème dans un an sans vous rappeler comment vous l'avez résolu. La recherche vous sauvera à nouveau.

Respecter le temps des autres

Facilitez au maximum la vie des personnes à qui vous demandez de l’aide.

Assurez-vous que les liens que vous envoyez fonctionnent. Essayez de l'ouvrir en mode navigation privée. Si le lien nécessite une autorisation, vous verrez une erreur d'accès. Par exemple, si vous avez téléchargé du code dans un référentiel privé ou envoyé un lien vers Google Drive, auquel vous seul avez accès, une personne verra une erreur et devra passer du temps à vous en informer, puis attendre vous de configurer l'accès. Assurez-vous que la personne voit immédiatement de quoi vous parlez.

Ne vous attendez pas à ce que quiconque veuille se souvenir de ce que vous avez demandé il y a deux jours. Renvoyez à nouveau l’information, rappelez le contexte. Personne ne veut chercher dans la correspondance ce que vous avez sous la main. Si vous êtes trop paresseux pour dupliquer des informations afin que les gens ne perdent pas leur temps à chercher, alors vous n’avez pas besoin d’aide.

Ne le sortez pas de son contexte. Si vous envoyez un journal avec une erreur, il est évident que vous devez inclure non seulement l'erreur elle-même, mais également le code qui l'a provoquée, avec un exemple de ce qu'elle a cassé.
S'il existe un processus établi pour résoudre votre problème, suivez-le. Il n'est pas nécessaire de réinventer la roue s'il existe déjà un article contenant un guide pratique étape par étape.

Vous ne devriez pas essayer d'obtenir une réponse d'une personne via différents canaux (écrire sur Slack, Skype, Telegram) en même temps - ce serait désagréable pour la personne.

Inutile d’écrire le même message à plusieurs personnes à la fois, dans l’espoir qu’au moins quelqu’un vous réponde. Toutes ces personnes peuvent vous donner une réponse (ce sera très probablement la même), mais elles seront toutes distraites de leur travail pendant un moment. Utilisez les discussions de groupe.

Regarder plus large

Tout ce dont nous avons parlé ici s’applique également en dehors du domaine informatique. Suivez ces règles dans un supermarché, un centre de service automobile, en vacances dans un autre pays, lorsque vous communiquez avec des amis et des proches. Montrez aux gens que vous appréciez leur temps et que vous ne voulez pas les déranger pour des bagatelles. Montrez que vous avez consacré du temps et des efforts à essayer de résoudre le problème vous-même, mais que vous n'avez pas réussi et que vous avez vraiment besoin d'aide. En signe de gratitude, les gens comprendront vos problèmes et vous aideront à les résoudre.

Source: habr.com

Ajouter un commentaire