¿Cómo hacer una presentación para sus compañeros de trabajo que contenga mucho código? [cerrado]

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 preparé una pequeña muestra de aplicación. Mi pregunta es, ¿cómo presento el código para que la gente pueda seguirlo?

Algunas cosas que pensé:

• Poner el código en las diapositivas de PowerPoint, se ve bastante mal y, a menos que sea una imagen, no puedo hacer que el resaltado de sintaxis funcione. Tener mi código en imágenes es una molestia y no escala bien a diferentes resoluciones.
• Jugué con el formato de presentación S5 XHTML e integré un resaltador de sintaxis JavaScript. Es un poco torpe pero factible (tendré un poco de pena por ignorar el CI de la compañía para las presentaciones ya que no usaría sus plantillas. Ni siquiera pregunte ...)
• Podría armar un script (notas) y "código en vivo" delante de mi audiencia Esto no me gusta tanto porque me mantiene tan ocupado que me cuesta dar una buena explicación mientras escribo. Y también hay una alta probabilidad de que yo cause errores y los haga esperar.
• ¿Un screencast? Pero entonces no tendría que estar allí ... ¿Quizás narrarlo?

Entonces, ¿qué harías?

Answer 1

  

Podría armar un guión y   " código en vivo " delante de mi audiencia yo   no me gusta tanto porque   me mantiene tan ocupado que es difícil para mí   para dar una buena explicación mientras yo   escribir. Y también hay una gran posibilidad   de mí causando errores y hacerlos   espera.

Me gusta esta opción, si puede optimizar su demostración hasta el punto de no detener a la audiencia. Puedes hacer lo que hacen los cocineros de TV cuando la receta lleva más tiempo del que tienen; comience la codificación, luego avance a una que esté hecha al 90% o al 100%.

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

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

Answer 2

¿Su IDE permite abrir / 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 hacer esto, puede crear sus ejemplos de código como regiones y luego abrirlos / cerrarlos a medida que avanza su presentación. Puede alternar entre su presentación y muestras de código en el IDE, pero no tendría que codificar sobre la marcha. El uso de abrir / cerrar le permite ocultar el código al que no hace referencia para mantener las cosas menos desordenadas.

Realmente vi esto en Agile 2008 y parecía funcionar bastante bien.

Answer 3

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

Entonces, si no puede ajustarlo en una diapositiva de PowerPoint, debe repensar su enfoque.

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

Los programadores son programadores, probablemente harán preguntas cuando lleguen a lo técnico, lo cual es bueno.

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

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

Answer 4

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

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

Answer 5

Si no les gusta Powerpoint, no lo use. Utilizamos la grabación de pantalla de Camtasia para grabar demostraciones 'en vivo' para su presentación a los clientes (en vivo, ya que no tiene la desventaja de colapsar a la mitad de su presentación :-). Siempre prefieren verlo en acción en lugar de lo que creen que es una funcionalidad fraudulenta.

Se puede pausar como las diapositivas de Powerpoint y tiene la ventaja de colorear la sintaxis, ya que solo graba la presentación 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 es divertido verlas en acción).

Esto básicamente corresponde a su idea de screencast, pero, si desea 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 totalmente narrada al público objetivo, pero eso es porque no estoy totalmente superado por mi fobia de hablar en público al principio de la carrera :-).

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

Answer 6

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

Consigue que otra persona te ayude. Mientras habla sobre el código, deje que el ayudante escriba el código. De esta manera, todos en la sala verán el código, mientras te escuchan explicarlo.

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

Answer 7

Si pudiera hacerlo todo en un screencast y no tuviera que estar allí, entonces haga un screencast y no esté allí. Nadie se queja cuando se cancela una reunión. Simplemente distribuya el video, tal vez con un informe adjunto con notas o enlaces para que las personas puedan leer más sobre las herramientas que está demostrando.

Y obtendrás más crédito más tarde cuando tus compañeros de trabajo y gerentes hablen con otras personas: "Oye, ¿viste la presentación que hizo Bibac? ¿No? Debieras; Te enviaré la dirección después del almuerzo. & Quot;

Si está demostrando código en la presentación, considere también tener disponible el proyecto terminado para que las personas puedan probarlo por ellos mismos.

Answer 8

Cuando doy presentaciones relacionadas con Visual Studio, pongo fragmentos de código en la pestaña general de la caja de herramientas. Durante la presentación, suelto / arrastro estos fragmentos de código en un archivo de código, página de marcado, etc.