Comment faire une présentation pour vos collègues contenant beaucoup de code? [fermé]

Question

Je suis censé faire une présentation pour mes collègues sur un framework Web que j'ai évalué. Ces personnes sont des développeurs et détestent les trucs PowerPoint longs et ennuyeux, alors j’ai eu plein de petits extraits de code. J'ai également mis en place un petit exemple d'application. Ma question est la suivante: comment puis-je présenter le code pour que les gens puissent suivre?

Certaines choses auxquelles j'ai pensé:

• Mettez le code sur des diapositives PowerPoint, ça a l'air très mauvais et à moins que ce ne soit une image, je ne parviens pas à utiliser la coloration syntaxique. Avoir mon code en image est une douleur et ne s'adapte pas bien à différentes résolutions.
• J'ai joué avec le format de présentation XHTML S5 et intégré un surligneur de syntaxe JavaScript. C'est un peu maladroit mais pratique (j'aurai un peu de peine à ne pas tenir compte des informations confidentielles de l'entreprise pour les présentations, car je n'utiliserais pas leurs modèles. Ne demandez même pas ...)
• Je pourrais composer un script (notes) et un "code live". devant mon public. Je n'aime pas trop cela parce que cela me tient tellement occupé qu'il m'est difficile de donner une bonne explication pendant que j'écris. Et il y a également de fortes chances que je provoque des erreurs et les fasse attendre.
• Un screencast? Mais alors je n'aurais pas à être là ... Peut-être le raconter?

Alors que feriez-vous?

Answer 1

  

Je pourrais mettre en place un script et   " code live " devant mon public. je   n'aime pas tellement ça parce que   me tient tellement occupé que c'est dur pour moi   pour donner une bonne explication pendant que je   écrire. Et il y a aussi une grande chance   de moi causer des erreurs et les rendre   attendez.

J'aime cette option, si vous pouvez rationaliser votre démo au point de ne pas retenir le public. Vous pouvez faire ce que font les cuisiniers à la télévision lorsque la recette prend plus de temps qu’ils n’en ont; commencez le codage, puis passez à celui qui est terminé à 90% ou à 100%.

Si vous avez un collègue, vous pouvez vous mettre à niveau, vous pouvez lui demander de coder pendant que vous parlez et d'indiquer ce qu'il fait.

Vous pouvez utiliser votre IDE, qui indiquera la syntaxe en surbrillance et montrera à votre auditoire comment compiler, déployer, tester, etc. Je vous recommanderais toutefois d'utiliser une police surdimensionnée, uniquement pour la session, afin que tout le monde puisse voir.

Answer 2

Votre environnement de développement autorise-t-il l’ouverture / la fermeture de régions ou de segments de code? Dans Visual Studio, vous pouvez créer des régions de code que vous pouvez développer ou réduire. Si votre IDE est capable de le faire, vous pouvez créer vos exemples de code sous forme de régions, puis les ouvrir / les fermer au fur et à mesure de votre présentation. Vous pouvez basculer entre votre présentation et les exemples de code dans l'EDI, sans devoir coder à la volée. Utiliser open / close vous permet de masquer le code que vous ne référencez pas pour que tout soit moins encombré.

En fait, j’ai vu cela se réaliser à Agile 2008 et cela semblait plutôt bien fonctionner.

Answer 3

Vous ne pouvez insérer que trop d'informations sur une diapositive PowerPoint, mais c'est en fait une bonne chose: les gens ne peuvent que regarder une certaine quantité d'informations et en tirer quelque chose de significatif.

Donc, si vous ne pouvez pas l'adapter à une diapositive PowerPoint, vous devez repenser votre approche.

Les extraits de code sont bons. Ils n'ont pas besoin d'être mis en évidence. Il suffit de les mettre dans Courier New (ou dans une autre police à largeur fixe) pour que le code apparaisse. Les extraits de code ne doivent pas nécessairement être complets non plus. Résumez-les simplement aux concepts essentiels (utilisez des commentaires ou des points de suspension pour indiquer le code manquant).

Les programmeurs étant des programmeurs, ils poseront probablement des questions à propos de la technique, ce qui est bon.

De plus, si les programmeurs sont familiarisés avec quelque chose de similaire, essayez de relier tous les concepts à ce qu’ils savent. Cela facilite la compréhension. Par exemple, si vous expliquez Spring MVC et qu'ils connaissent Struts, expliquez les équivalents Struts. Il peut être utile de mettre ce genre de chose sous forme de tableau (même sous forme de document).

C’est ce que j’ai fait exactement pour cela (un amorce Spring MVC pour les programmeurs Struts).

Answer 4

Si vous souhaitez que votre auditoire voie de nombreux extraits de code, en particulier des extraits volumineux, vous pouvez les imprimer sous forme de documentation ou les fournir sous forme de notes au format PDF ou sous forme de fichiers texte (les utilisateurs peuvent les suivre sur leur ordinateur portable).

Les diapositives de présentation doivent contenir le moins de texte possible (code compris) nécessaire pour véhiculer vos idées. S'il y a beaucoup de choses à lire à distance, votre auditoire sera fatigué après un certain temps et aura peut-être du mal à suivre. Laissez les utilisateurs lire l'intégralité des sections de code sur leur ordinateur portable ou dans leur propre document, tout en attirant l'attention sur les éléments essentiels de vos diapositives ou scripts de présentation.

Answer 5

S'ils n'aiment pas Powerpoint, ne l'utilisez pas. Nous utilisons l’enregistrement sur écran Camtasia pour enregistrer des démos «en direct» à présenter aux clients (en direct, entre guillemets, car cela n’a pas l’inconvénient de planter à mi-parcours de votre présentation :-). Ils préfèrent toujours le voir en action plutôt que ce qu’ils pensent être une fonctionnalité falsifiée.

Il est capable de mettre en pause vos diapositives PowerPoint et présente l’avantage de la coloration syntaxique puisque vous enregistrez simplement en le mettant dans votre éditeur favori. C'est aussi dynamique, ce qui est bien meilleur que Powerpoint (bien que j'ai déjà vu certaines personnes faire de l'animation grossière avec plusieurs diapositives PowerPoint, toujours marrantes à regarder en action).

Ceci correspond en gros à votre idée de screencast mais, si vous voulez une raison d’être là-bas, faites un grand nombre de petits screencasts pour les disperser entre votre présentation réelle, en racontant (en personne, pas sur le screencast) si nécessaire.

Personnellement, je préférerais envoyer un Camtasia entièrement commenté au public cible, mais c’est parce que je n’ai pas complètement dépassé ma phobie de prise de parole en début de carrière: -).

À la rigueur, vous pourriez faire une véritable démo en direct, car votre public (les vidéos sont l’équivalent pour les présentations vidéo?) sont des programmeurs et comprendront tous vos problèmes.

Answer 6

Je me suis fait faire ça et je pensais que c'était la meilleure solution possible:

Demandez à une autre personne de vous aider. Pendant que vous parlez du code, laissez l’assistant le taper. Ainsi, tout le monde dans la salle examinera le code tout en vous écoutant expliquer le code.

Ceci implique bien sûr de trouver quelqu'un qui puisse vous aider et qui comprend le code aussi bien que vous le faites. Mais les résultats peuvent être excellents.

Answer 7

Si vous pouviez tout faire en screencast et que vous ne deviez pas être là, faites un screencast et ne soyez pas là. Personne ne se plaint quand une réunion est annulée. Diffusez simplement la vidéo, éventuellement avec un rapport accompagné de notes ou de liens, pour que les gens puissent en savoir plus sur les outils que vous présentez.

Et vous obtiendrez plus de crédit plus tard, lorsque vos collègues et vos gestionnaires parleront à d’autres personnes: "Hé, avez-vous vu la présentation que Bibac a faite?" Non? Vous devriez; Je vous enverrai l'adresse après le déjeuner. "

Si vous démontrez du code dans la présentation, envisagez également de disposer du projet terminé pour que les utilisateurs puissent l'essayer eux-mêmes.

Answer 8

Lorsque je donne des présentations impliquant Visual Studio, je place des extraits de code dans l'onglet Général de la boîte à outils. Au cours de la présentation, je fais glisser ces extraits de code dans un fichier de code, une page de balisage, etc.