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

language-agnostic slideshow

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é:

• Coloque el código en las diapositivas de PowerPoint, se ve bastante mal y, a menos que sea una imagen, no puedo obtener resaltado de sintaxis para que funcione. 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 viable (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 un "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?

Entonces, ¿qué harías?

Answer 1

Podría armar un guión y un "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.

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 tienes un colega puedes ponerte al día, puedes pedirles que hagan la codificación mientras hablas 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

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.

Es capaz de pausar al igual que tus diapositivas Powerpoint y tiene la ventaja de la coloración de sintaxis, ya que solo grabas para que aparezcas en tu 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 transmisión de pantalla pero, si desea una razón para estar allí, haga una gran cantidad de pequeñas grabaciones de pantalla para mostrar intercaladas entre su presentación real, narrando (en persona, no en el screencast) si es necesario.

Personalmente, preferiría enviar una Camtasia completamente narrada a la audiencia objetivo, pero eso se debe a que no estoy totalmente de acuerdo con mi fobia a la primera etapa 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 4

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

Entonces, si no puede caber en una diapositiva de PowerPoint, necesita 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 5

Me hicieron esto y pensé que era la mejor solución posible:

Consigue a otra persona para que te ayude. 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 cantidad más pequeña de texto (incluido el código) necesaria para transmitir sus ideas. Si hay mucho que leer desde la distancia, tu audiencia se cansará después de un tiempo y podría 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, ¿vio la presentación que hizo Bibac? No, debería; 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 ofrezco presentaciones en Visual Studio, pongo 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, una página de marcado, etc.