Как сделать презентацию для ваших сотрудников, содержащих много кода?

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

Некоторые вещи, о которых я думал:

Поместите код в слайды PowerPoint, выглядит довольно плохо, и если это не изображение, я не могу заставить подсветку синтаксиса работать. Наличие моего кода в изображениях является болью и недостаточно масштабируется для разных разрешений.
Я играл с форматом презентации S5 XHTML и интегрировал синтаксис синтаксиса JavaScript. Это немного неуклюже, но работоспособно (я буду испытывать горечь за игнорирование компании CI для презентаций, так как я не буду использовать их шаблоны. Даже не спрашивайте...)
Я мог собрать script (заметки) и "живой код" перед моей аудиторией. Мне это не так нравится, потому что он держит меня настолько занятым, что мне трудно дать хорошее объяснение, пока я пишу. И также есть высокая вероятность того, что я причиню ошибки и заставит их ждать.
Скринкаст? Но тогда мне не обязательно быть там... Может быть, рассказать об этом?

Итак, что бы вы сделали?

Ответ 1

Я мог бы собрать script и "живой код" перед моей аудиторией. я это не так нравится, потому что это держит меня таким занятым, что мне тяжело дать хорошее объяснение, пока я написать. А также высокий шанс я вызываю ошибки и делаю их ждать.

Мне нравится этот вариант, если вы можете упростить свою демонстрацию до такой степени, чтобы не поднять аудиторию. Вы можете делать то, что делают повара по телевизору, когда рецепт занимает больше времени, чем у них; начните кодирование, затем перейдите вперед к тому, что сделано на 90% или 100%.

Если у вас есть коллега, вы можете ускориться, вы можете заставить их делать кодировку, пока вы говорите, и указываете, что они делают.

Вы можете использовать свою среду IDE, которая даст подсветку синтаксиса и покажет вашей аудитории, как компилировать, развертывать, тестировать и т.д. Я бы рекомендовал использовать негабаритный шрифт, хотя и для сеанса, чтобы каждый мог видеть.

Ответ 2

Позволяет ли ваша среда IDE открывать/закрывать регионы или сегменты кода? В Visual Studio вы можете создавать регионы кода, которые можно развернуть или свернуть. Если ваша IDE имеет возможность сделать это, вы можете создать свои образцы кода в качестве регионов, а затем открыть/закрыть их при прохождении презентации. Вы можете переключаться между презентацией и образцами кода в среде IDE, но не нужно вводить код "на лету". Использование open/close позволяет вам скрыть код, на который вы не ссылаетесь, чтобы вещи были менее загроможденными.

Я действительно видел это на Agile 2008, и, похоже, он работал очень хорошо.

Ответ 3

Вы можете разместить столько информации на слайде PowerPoint, но это действительно хорошо: люди могут смотреть только на определенный объем информации и получать от нее что-то значимое.

Итак, если вы не можете поместить его на слайд PowerPoint, вам нужно переосмыслить свой подход.

Фрагменты кода хороши. Их не нужно выделять. Просто поместите их в Courier New (или какой-нибудь другой шрифт с фиксированной шириной), и он встречается как код. Фрагменты кода также не должны быть полными. Просто сводите их к основным понятиям (используя комментарии или эллипсы, чтобы указать отсутствующий код).

Программисты, программисты, они, вероятно, зададут вопросы, когда доберутся до технического, что хорошо.

Кроме того, если программисты знакомы с чем-то подобным, попытайтесь связать все концепции с тем, что они знают. Это облегчает понимание. Например, если вы объясняете Spring MVC, и они знают Struts, объясните эквиваленты Struts. Полезно поместить такие вещи в виде таблицы (даже в виде раздаточного материала).

То, что я сделал для этого (Spring MVC-праймер для программистов Struts).

Ответ 4

Если вы хотите, чтобы ваша аудитория увидела множество фрагментов кода, особенно длинных, вы могли распечатать их в виде раздаточных материалов или предоставить их в виде заметок в PDF или текстовых файлах (люди могут следить за их ноутбуками).

Фактические слайды презентации должны содержать наименьший объем текста (включая код), необходимый для передачи ваших идей. Если есть много, чтобы читать издалека, ваша аудитория устанет через некоторое время и может столкнуться с трудностями. Пусть люди читают полные разделы кода на своих ноутбуках или раздаточных материалах, обращая внимание только на критические части слайдов презентации или script.

Ответ 5

Если они не любят Powerpoint, не используйте его. Мы используем видеозапись Camtasia для записи "живых" демонстраций для презентации для клиентов (в кавычки в реальном времени, поскольку у нее нет недостатка в сбое на полпути через презентацию:-). Они всегда предпочитают видеть это в действии, а не то, что, по их мнению, является фьюдированной функциональностью.

Эта пауза, как и ваши слайды Powerpoint, имеет преимущество синтаксической раскраски, так как вы просто записываете ее в свой любимый редактор. Это также динамичный, который намного лучше, чем Powerpoint (хотя я видел, как некоторые люди делают грубую анимацию с несколькими слайдами Powerpoint, всегда забавно наблюдать за действиями).

Это в основном отображает вашу идею, но если вам нужна причина, чтобы сделать это, сделайте большое количество небольших скринкастов, чтобы показать, что вы перемежались между вашим реальным представлением, в случае необходимости повествуя (лично, а не на скринкасте).

Лично я бы предпочел отправить полностью рассказанную Camtasia на целевую аудиторию, но это потому, что я не полностью из-за своей ранней карьеры фобии публичных выступлений: -).

В крайнем случае вы могли бы сделать настоящую живую демонстрацию, так как ваша аудитория (эквивалент видео для презентаций?) является программистом и будет понимать любые проблемы, которые у вас есть.

Ответ 6

Я сделал это со мной и подумал, что это наилучшее решение:

Получить другого человека, который поможет вам. Пока вы говорите о коде, пусть хелпер вводит код. Таким образом, все в комнате будут смотреть на код, слушая, как вы это объясняете.

Это, конечно, предполагает поиск того, кто может помочь, и понять код так же хорошо, как и вы. Но результаты могут быть большими.

Ответ 7

Если бы вы могли сделать все это в скринкасте, и вам не обязательно быть там, тогда сделайте скринкаст и не будьте там. Никто не жалуется, когда собрание отменяется. Просто раздайте видео, возможно, сопутствующий отчет с заметками или ссылками, чтобы люди могли больше узнать о инструментах, которые вы демонстрируете.

И вы получите больше кредитов позже, когда ваши коллеги и менеджеры поговорят с другими людьми: "Эй, вы видели презентацию, которую сделал Бибак? Нет? Вы должны, я пришлю вам адрес после обеда".

Если вы демонстрируете код в презентации, а затем подумайте о том, что готовый проект доступен, чтобы люди могли попробовать его сами.

Ответ 8

Когда я даю презентации с участием Visual Studio, я помещаю фрагменты кода на общую вкладку панели инструментов. Во время презентации я отбрасываю/перетаскиваю эти фрагменты кода в файл кода, страницу разметки и т.д.