¿Cómo hacer una presentación para sus compañeros de trabajo que contiene muchos códigos?

Question

Se supone que debo hacer una presentación para mis compañeros de trabajo en un marco web que evalué. Estas personas son desarrolladores y odian las cosas largas y aburridas de PowerPoint, así que obtuve muchos pequeños fragmentos de código. También armé una pequeña aplicación de muestra. Mi pregunta es, ¿cómo presento el código para que la gente pueda seguirlo?

Algunas cosas que pensé:

• poner el código de diapositivas de PowerPoint, parece bastante malo y menos que sea una imagen que no puedo conseguir resaltado de sintaxis para trabajar. Tener mi código en las imágenes es un problema y no se adapta bien a diferentes resoluciones.
• Jugué con el formato de presentación S5 XHTML e integé un resaltador de sintaxis JavaScript. Es un poco torpe pero factible (me daría un poco de pena por ignorar el CI de la empresa para las presentaciones ya que no usaría sus plantillas. Ni siquiera pregunte ...)
• Podría armar un guión (notas) y "código en vivo" frente a mi audiencia. No me gusta tanto porque me mantiene tan ocupado que es difícil para mí dar una buena explicación mientras escribo. Y también hay una gran probabilidad de que cause errores y los haga esperar.
• ¿Un screencast? Pero entonces no tendría que estar allí ... ¿Tal vez narrarlo?

¿Qué harías?

Answer 1

Pude armar un script y "live-code" delante de mi audiencia. I no me gusta tanto porque me mantiene tan ocupado que es difícil para mí dar una buena explicación mientras escribo . Y también hay una gran posibilidad de que cause errores y hacer que esperen.

Me gusta esta opción, si puede hacer que su demostración sea eficiente hasta el punto de no retrasar a la audiencia. Puedes hacer lo que hacen los cocineros de TV cuando la receta lleva más tiempo del que tienen; comienza la codificación, luego salta a uno que está 90% o 100% hecho.

Si tiene un colega, puede ponerse al día, hacer que codifiquen mientras habla y señalar lo que están haciendo.

Puede usar su IDE, que le dará el resaltado de sintaxis y le mostrará a su audiencia cómo compilar, implementar, probar, etc. Sin embargo, recomendaría usar una fuente de gran tamaño para la sesión, para que todos puedan ver.

Answer 2

¿Su IDE permite abrir o cerrar regiones o segmentos de código? En Visual Studio puede crear regiones de código que puede expandir o contraer. Si su IDE tiene la capacidad de hacerlo, puede crear muestras de código como regiones y luego abrirlas/cerrarlas a medida que avanza en su presentación. Podría alternar entre su presentación y las muestras de código en el IDE, pero no tendría que codificar sobre la marcha. Usar abrir/cerrar le permite ocultar el código al que no hace referencia para mantener las cosas menos desordenadas.

De hecho, vi esto hecho en Agile 2008 y pareció funcionar bastante bien.

Answer 3

Solo puede incluir tanta información en una diapositiva de PowerPoint, pero eso es realmente una buena cosa: las personas solo pueden ver cierta cantidad de información y obtener algo significativo de ella.

Así que si no puede caber en una diapositiva de PowerPoint, debe replantearse su enfoque.

Los fragmentos de código son buenos. No necesitan ser resaltados. Simplemente colóquelos en Courier New (o en alguna otra fuente de ancho fijo) y aparecerá como código. Los fragmentos de código no tienen que estar completos tampoco. Simplemente hiérvalos a los conceptos esenciales (usando comentarios o elipsis para indicar el código que falta).

Los programadores son programadores, probablemente hagan preguntas cuando llegue el técnico, lo cual es bueno.

Además, si los programadores están familiarizados con algo similar, intente y relacione todos los conceptos con lo que saben. Lo hace más fácil de entender. Como si estuvieras explicando Spring MVC y conocen a Struts, explica los equivalentes de Struts. Puede ser útil poner ese tipo de cosas en forma de tabla (incluso como un folleto).

Eso es exactamente lo que hice (un manual de Spring MVC para los programadores de Struts).

Answer 4

Si no les gusta Powerpoint, no lo utilicen. Usamos la grabación de pantalla de Camtasia para grabar demos en vivo para presentarlas a los clientes (entre comillas, ya que no tiene la desventaja de estrellarse a la mitad de su presentación :-). Siempre prefieren verlo en acción en lugar de lo que creen que es una funcionalidad fingida.

Se puede pausar al igual que las diapositivas de Powerpoint y tiene la ventaja de la coloración de sintaxis, ya que acaba de grabar y aparece en su editor favorito. También es dinámico, que es mucho mejor que Powerpoint (aunque he visto a algunas personas hacer animaciones crudas con múltiples diapositivas de Powerpoint, siempre divertidas de ver en acción).

Esto básicamente se relaciona con su idea de screencast pero, si quiere una razón para estar allí, haga una gran cantidad de pequeños screencasts para mostrar intercalados entre su presentación real, narrando (en persona, no en el screencast) si es necesario.

Personalmente, preferiría enviar una Camtasia completamente narrada al público objetivo, pero eso se debe a que no he superado por completo mi fobia al principio de la carrera de hablar en público :-).

En caso de apuro, podría hacer una demostración en vivo real ya que su audiencia (¿es el equivalente en video de las presentaciones?) Son programadores y comprenderán cualquier problema que tenga.

Answer 5

tenía este hecho a mí, y pensé que era la mejor solución posible:

lograr que otra persona para ayudarle a salir. Mientras habla sobre el código, deje que el ayudante escriba el código. De esta forma, todos en la sala mirarán el código, mientras lo escuchan lo explican.

Esto, por supuesto, implica encontrar a alguien que pueda ayudar, y comprender el código tan bien como usted. Pero los resultados pueden ser grandiosos.

Answer 6

Si desea que su audiencia vea muchos fragmentos de código, especialmente los largos, puede imprimirlos como folletos o proporcionarlos como notas en PDF o archivos de texto (la gente puede seguirlos en sus computadoras portátiles).

Las diapositivas de presentación reales deben contener la menor cantidad de texto (incluido el código) necesario para transmitir sus ideas. Si hay mucho que leer desde la distancia, su audiencia se cansará después de un tiempo y puede tener problemas para seguir. Permita que las personas lean las secciones completas del código en sus propias computadoras portátiles o folletos, mientras llama la atención solo sobre las partes críticas en sus diapositivas o guiones de presentación.

Answer 7

Si pudieras hacerlo todo en un screencast y no tendrías que estar allí, entonces haz un screencast y no estarías allí. Nadie se queja cuando se cancela una reunión. Simplemente distribuya el video, tal vez con un informe acompañante con notas o enlaces para que la gente pueda leer más sobre las herramientas que está demostrando.

Y obtendrá más crédito más adelante cuando sus compañeros de trabajo y gerentes le hablen a otras personas: "Oye, ¿vieron la presentación que hizo Bibac? No, debe: le enviaré la dirección después del almuerzo. "

Si está demostrando código en la presentación, también considere tener el proyecto terminado disponible para que la gente pueda probarlo por sí mismo.

Answer 8

Cuando realizo presentaciones que involucran a Visual Studio, coloco fragmentos de código en la pestaña general de la caja de herramientas. Durante la presentación, coloco/arrastro estos fragmentos de código en un archivo de código, página de marcado, etc.