Come fare una presentazione per i tuoi colleghi contenente un sacco di codice? [chiuso]

Question

Dovrei fare una presentazione per i miei colleghi su un framework web che ho valutato. Queste persone sono sviluppatori e odiano le cose lunghe e noiose di PowerPoint, quindi ho molti piccoli frammenti di codice. Ho anche messo insieme una piccola applicazione di esempio. La mia domanda è: come posso presentare il codice in modo che le persone possano seguire?

Alcune cose a cui ho pensato:

• Metti il ??codice su diapositive di PowerPoint, sembra piuttosto male e se non è un'immagine non riesco a far funzionare l'evidenziazione della sintassi. Avere il mio codice nelle immagini è una seccatura e non si adatta bene a risoluzioni diverse.
• Ho giocato con il formato di presentazione S5 XHTML e ho integrato un evidenziatore di sintassi JavaScript. È un po 'goffo ma fattibile (avrò un po' di dolore per aver ignorato l'IC della società per le presentazioni poiché non avrei usato i loro modelli. Non chiedere nemmeno ...)
• Potrei mettere insieme uno script (note) e " live-code " di fronte al mio pubblico. Non mi piace così tanto perché mi tiene così impegnato che è difficile per me dare una buona spiegazione mentre scrivo. E c'è anche un'alta probabilità che io provochi errori e li faccia aspettare.
• Uno screencast? Ma poi non avrei dovuto essere lì ... Forse narrarlo?

Quindi cosa faresti?

Answer 1

  

Potrei mettere insieme una sceneggiatura e   & Quot; live-codice " di fronte al mio pubblico. io   non mi piace così tanto perché   mi tiene così impegnato che è difficile per me   per dare una buona spiegazione mentre io   Scrivi. E c'è anche un'alta possibilità   di me causa errori e li rende   attendere.

Mi piace questa opzione, se riesci a rendere la tua demo semplificata al punto da non trattenere il pubblico. Puoi fare ciò che i cuochi TV fanno quando la ricetta richiede più tempo di loro; avvia la codifica, quindi passa a uno che ha eseguito il 90% o il 100%.

Se hai un collega puoi metterti al passo, puoi fargli scrivere il codice mentre parli e sottolineare cosa stanno facendo.

Puoi usare il tuo IDE, che darà l'evidenziazione della sintassi e mostrerà al tuo pubblico come compilare, distribuire, testare, ecc. Raccomanderei comunque di usare un carattere sovradimensionato, solo per la sessione, in modo che tutti possano vederlo.

Answer 2

Il tuo IDE consente di aprire / chiudere regioni o segmenti di codice? In Visual Studio è possibile creare aree di codice che è possibile espandere o comprimere. Se il tuo IDE ha la possibilità di farlo, potresti creare i tuoi esempi di codice come regioni e quindi aprirli / chiuderli mentre procedi con la presentazione. È possibile passare da una presentazione all'altra e esempi di codice nell'IDE, ma non è necessario codificare al volo. L'uso di open / close ti consente di nascondere il codice a cui non stai facendo riferimento per mantenere le cose meno disordinate.

L'ho visto effettivamente fatto ad Agile 2008 e sembrava funzionare abbastanza bene.

Answer 3

Puoi inserire solo così tante informazioni su una diapositiva di PowerPoint, ma in realtà è una buona cosa: le persone possono solo guardare una certa quantità di informazioni e trarne qualcosa di significativo.

Quindi se non riesci ad adattarlo a una diapositiva di PowerPoint, devi ripensare il tuo approccio.

Gli snippet di codice sono buoni. Non hanno bisogno di essere evidenziati. Inseriscili nel Courier New (o in qualche altro font a larghezza fissa) e verrà visualizzato come codice. Nemmeno i frammenti di codice devono essere completi. Basta ridurli ai concetti essenziali (usando commenti o ellissi per indicare il codice mancante).

I programmatori essendo programmatori, probabilmente faranno domande quando si tratta di aspetti tecnici, il che è positivo.

Inoltre, se i programmatori hanno familiarità con qualcosa di simile, prova a ricollegare tutti i concetti a ciò che sanno. Rende più facile da afferrare. Ad esempio, se stai spiegando Spring MVC e loro conoscono Struts, spiega gli equivalenti Struts. Può essere utile mettere quel genere di cose in forma di tabella (anche come dispensa).

Questo è quello che ho fatto esattamente per questo (un primer Spring MVC per programmatori Struts).

Answer 4

Se vuoi che il tuo pubblico veda molti frammenti di codice, specialmente quelli lunghi, puoi stamparli come dispense o fornirli come note in PDF o file di testo (le persone possono seguirli sui loro laptop).

Le diapositive di presentazione effettive dovrebbero contenere la minima quantità di testo (incluso il codice) necessaria per trasmettere le tue idee. Se c'è molto da leggere a distanza, il tuo pubblico si stancherà dopo un po 'e potrebbe avere problemi a seguirlo. Consenti alle persone di leggere le sezioni di codice complete sui propri laptop o dispense, richiamando l'attenzione solo sulle parti critiche delle diapositive o degli script della presentazione.

Answer 5

Se non amano Powerpoint, non usarlo. Usiamo la registrazione dello schermo di Camtasia per registrare demo 'live' per la presentazione ai clienti (live tra virgolette poiché non ha lo svantaggio di schiantarsi a metà della presentazione :-). Preferiscono sempre vederlo in azione piuttosto che ciò che pensano sia una funzionalità confusa.

È in grado di mettere in pausa come le diapositive di Powerpoint e ha il vantaggio di colorare la sintassi poiché hai appena registrato portando il tuo editor preferito. È anche dinamico che è molto meglio di Powerpoint (anche se ho visto alcune persone fare animazioni grezze con più diapositive di Powerpoint, sempre divertenti da guardare in azione).

Questo fondamentalmente si associa alla tua idea di screencast ma, se vuoi un motivo per essere lì, fai un gran numero di piccoli screencast per mostrare intervallati tra la tua vera presentazione, narrando (di persona, non sullo screencast) se necessario.

Personalmente, preferirei inviare una Camtasia completamente narrata al pubblico di destinazione, ma è perché non sono totalmente sopra la mia fobia di parlare in pubblico all'inizio della carriera :-).

In un pizzico, potresti fare una vera dimostrazione dal vivo poiché il tuo pubblico (è videance l'equivalente per le presentazioni video?) sono programmatori e capiranno tutti i tuoi problemi.

Answer 6

L'ho fatto per me e ho pensato che fosse la migliore soluzione possibile:

Chiedi a un'altra persona di aiutarti. Mentre parli del codice, lascia che l'helper digiti il ??codice. In questo modo tutti nella stanza guarderanno il codice, mentre ti ascoltano spiegarlo.

Questo ovviamente implica trovare qualcuno che possa dare una mano e capire il codice proprio come te. Ma i risultati possono essere fantastici.

Answer 7

Se potessi fare tutto in uno screencast e non dovresti essere lì, fai uno screencast e non essere lì. Nessuno si lamenta quando una riunione viene annullata. Distribuisci il video, magari con un rapporto di accompagnamento con note o collegamenti in modo che le persone possano leggere di più sugli strumenti che stai dimostrando.

E otterrai più credito in seguito mentre i tuoi colleghi e manager parlano con altre persone: " Ehi, hai visto la presentazione che Bibac ha fatto? No? Dovresti; Ti invierò l'indirizzo dopo pranzo. & Quot;

Se stai dimostrando il codice nella presentazione, considera anche la disponibilità del progetto finito in modo che le persone possano provarlo da soli.

Answer 8

Quando faccio presentazioni che coinvolgono Visual Studio inserisco frammenti di codice nella scheda generale della casella degli strumenti. Durante la presentazione trascino / trascino questi frammenti di codice in un file di codice, in una pagina di markup, ecc.