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

Question

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

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

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

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

Answer 1

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

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

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

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

Answer 2

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

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

Answer 3

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

Поэтому, если вы не можете разместить это на слайде PowerPoint, вам нужно пересмотреть свой подход.

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

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

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

Это то, что я сделал именно для этого (Spring MVC primer для программистов Struts).

Answer 4

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

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

Answer 5

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

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

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

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

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

Answer 6

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

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

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

Answer 7

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

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

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

Answer 8

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