Я должен сделать презентацию для моих коллег о веб-фреймворке, который я оценил. Эти люди - разработчики и ненавидят длинные и скучные вещи в PowerPoint, поэтому у меня есть много маленьких фрагментов кода. Я также собрал небольшой образец приложения. У меня вопрос: как представить код, чтобы люди могли следить за ним?
Я подумал о некоторых вещах:
Так что бы ты сделал?





Допускает ли ваша IDE открытие / закрытие регионов или сегментов кода? В Visual Studio вы можете создавать области кода, которые можно развернуть или свернуть. Если в вашей среде IDE есть такая возможность, вы можете создавать образцы кода в виде регионов, а затем открывать / закрывать их по мере прохождения презентации. Вы можете переключаться между презентацией и примерами кода в среде IDE, но вам не придется писать код на лету. Использование open / close позволяет скрыть код, на который вы не ссылаетесь, чтобы вещи были менее загромождены.
Я действительно видел, как это было сделано на Agile 2008, и, похоже, это сработало очень хорошо.
I could put together a script and "live-code" in front of my audience. I don't like this so much because it keeps me so busy that it's hard for me to give a good explanation while I write. And there's also a high chance of me causing errors and make them wait.
Мне нравится этот вариант, если вы можете упростить демо до такой степени, чтобы не задерживать аудиторию. Вы можете делать то, что делают повара по телевизору, когда рецепт занимает больше времени, чем у них есть; начните кодирование, а затем переходите к тому, что выполнено на 90% или 100%.
Если у вас есть коллега, вы можете быстро набрать обороты, вы можете попросить его писать код, пока вы говорите, и указывать на то, что они делают.
Вы можете использовать свою IDE, которая выделит синтаксис и покажет вашей аудитории, как компилировать, развертывать, тестировать и т. д. Я бы рекомендовал использовать слишком крупный шрифт только для сеанса, чтобы все могли видеть.
На слайде PowerPoint можно разместить не так много информации, но на самом деле это хорошо: люди могут просматривать только определенный объем информации и извлекать из нее что-то значимое.
Так что, если вы не можете разместить его на слайде PowerPoint, вам нужно переосмыслить свой подход.
Фрагменты кода хороши. Их не нужно выделять. Просто поместите их в Courier New (или какой-нибудь другой шрифт с фиксированной шириной), и он будет восприниматься как код. Фрагменты кода также не обязательно должны быть полными. Просто сведите их к основным понятиям (используя комментарии или многоточие для обозначения отсутствующего кода).
Программисты, будучи программистами, вероятно, зададут вопросы, когда дело доходит до технических вопросов, и это хорошо.
Кроме того, если программисты знакомы с чем-то подобным, попробуйте связать все концепции с тем, что они знают. Так легче понять. Например, если вы объясняете Spring MVC, а они знают Struts, объясните эквиваленты Struts. Может быть полезно поместить такие вещи в виде таблицы (даже в виде раздаточного материала).
Именно это я и сделал (учебник по Spring MVC для программистов Struts).
Если им не нравится Powerpoint, не используйте его. Мы используем запись экрана Camtasia для записи «живых» демонстраций для презентации клиентам (живые в кавычках, поскольку они не имеют недостатка в виде сбоев на полпути презентации :-). Они всегда предпочитают видеть это в действии, а не то, что, по их мнению, является фальшивой функциональностью.
Он может приостанавливаться, как и слайды Powerpoint, и имеет преимущество в виде раскраски синтаксиса, поскольку вы просто записываете свое поднятие в своем любимом редакторе. Он также динамичен, что намного лучше, чем Powerpoint (хотя я видел, как некоторые люди делали грубую анимацию с несколькими слайдами Powerpoint, всегда забавно наблюдать в действии).
Это в основном соответствует вашей идее скринкаста, но, если вы хотите, чтобы у вас была причина, сделайте большое количество небольших скринкастов, чтобы показать их вкрапления между вашей реальной презентацией, рассказывая (лично, а не на скринкасте), если необходимо.
Лично я бы предпочел послать целевую аудиторию полностью рассказанной Camtasia, но это потому, что я еще не полностью избавился от своей фобии публичных выступлений в начале карьеры :-).
В крайнем случае, вы могли бы сделать настоящую живую демонстрацию, поскольку ваша аудитория (является ли видимость эквивалентом видеопрезентаций?) - программисты и поймут любые ваши проблемы.
Я сделал это со мной и подумал, что это лучшее возможное решение:
Попросите другого человека помочь вам. Пока вы говорите о коде, позвольте помощнику набрать код. Таким образом, все в комнате будут смотреть на код, слушая, как вы его объясняете.
Это, конечно, предполагает поиск кого-то, кто может помочь и понять код так же хорошо, как и вы. Но результаты могут быть отличными.
Если вы хотите, чтобы ваша аудитория увидела много фрагментов кода, особенно длинных, вы можете распечатать их в виде раздаточных материалов или предоставить в виде заметок в PDF или текстовых файлах (люди могут следить за ними на своих ноутбуках).
Фактические слайды презентации должны содержать наименьшее количество текста (включая код), необходимого для передачи ваших идей. Если есть что читать на расстоянии, ваша аудитория через некоторое время устанет, и у нее могут возникнуть проблемы с чтением. Пусть люди читают полные разделы кода на своих ноутбуках или в раздаточных материалах, обращая внимание только на важные части слайдов презентации или сценария.
Если бы вы могли сделать все это в виде скринкаста, и вам бы не пришлось там присутствовать, сделайте скринкаст и не появляйтесь. Никто не жалуется, когда встреча отменяется. Просто распространите видео, возможно, с сопроводительным отчетом с примечаниями или ссылками, чтобы люди могли больше узнать об инструментах, которые вы демонстрируете.
И вы получите больше признательности позже, когда ваши коллеги и менеджеры будут говорить с другими людьми: «Эй, вы видели презентацию, которую сделал Бибак? Нет? Вам стоит; я пришлю вам адрес после обеда».
Если вы демонстрируете код в презентации, подумайте также о том, чтобы готовый проект был доступен, чтобы люди могли попробовать его сами.
Когда я провожу презентации с использованием Visual Studio, я помещаю фрагменты кода на общую вкладку панели инструментов. Во время презентации я перетаскиваю эти фрагменты кода в файл кода, страницу разметки и т. д.