2009-01-17 62 views
10

我應該爲我的同事在我評估的Web框架上做一個演示。這些人是開發人員,討厭漫長而無聊的PowerPoint的東西,所以我得到了很多小代碼片段。我也放了一個小樣本應用程序。我的問題是,我如何提交代碼以便人們可以遵循?如何爲包含大量代碼的同事進行演示?

有些事情,我認爲:

  • 放在PowerPoint幻燈片的代碼,看起來很糟糕,除非它是一個像我不能讓語法高亮工作。讓我的代碼在圖像中是一種痛苦,並且不能很好地適應不同的分辨率。
  • 我玩弄了S5 XHTML演示文稿格式,並集成了一個JavaScript語法突出顯示器。這有點笨拙但可行(因爲我不會使用他們的模板,所以我會因爲忽略公司的CI而感到一些悲傷,因爲我不會使用他們的模板,甚至不要問...)
  • 我可以把腳本(註釋)和「活代碼」在我的觀衆面前。我不喜歡這麼多,因爲它讓我非常忙碌,所以在寫作的時候我很難給出一個很好的解釋。而且我也有很高的機會導致錯誤並讓他們等待。
  • 截屏?但是,我不必在那裏......也許敘述它?

那麼你會怎麼做?

回答

5

我可以把一個腳本和 「實時代碼」放在我的聽衆面前。我 不喜歡這麼多,因爲它 讓我很忙,我 很難給我一個很好的解釋,而我 寫。而且我也有很高的機會導致我的錯誤,並讓他們等待 。

我喜歡這個選項,如果你能讓你的演示精簡到不阻礙觀衆的地步。當食譜需要更多時間時,你可以做電視廚師做的事情;開始編碼,然後跳到90%或100%完成。

如果你有一個同事,你可以加快速度,你可以讓他們在你說話時做編碼,並指出他們在做什麼。

您可以使用IDE,它會給出語法高亮顯示並向觀衆展示如何進行編譯,部署,測試等。我建議使用超大字體,但僅適用於會話,以便大家可以看到。

1

您的IDE允許打開/關閉區域或代碼段嗎?在Visual Studio中,您可以創建可以展開或摺疊的代碼區域。如果您的IDE有能力做到這一點,您可以將您的代碼示例創建爲區域,然後在演示過程中打開/關閉它們。您可以在IDE中的演示文稿和代碼示例之間來回切換,但無需進行即時編碼。使用open/close可以讓你隱藏你沒有引用的代碼,以減少混亂。

我在Agile 2008上看到了這一點,它似乎工作得很好。

1

你只能在PowerPoint幻燈片上容納這麼多信息,但這實際上是一件好事:人們只能看到一定量的信息並從中獲得一些有意義的信息。

所以,如果你不適合PowerPoint幻燈片,你需要重新思考你的方法。

代碼片段很好。他們不需要突出顯示。只需將它們放入Courier New(或其他固定寬度的字體)中即可,它會作爲代碼出現。代碼片段不一定要完整。將它們歸結爲基本概念(使用註釋或省略號來表示缺少的代碼)。程序員是程序員,他們可能會問到技術問題,這很好。另外,如果程序員熟悉類似的東西,試着把所有的概念都回溯到他們所知道的東西。它使得它更容易掌握。就像你在解釋Spring MVC和他們瞭解Struts一樣,解釋Struts的等價物。以表格的形式放置這種東西可能是有用的(甚至作爲講義)。

這正是我所做的(Struts程序員的Spring MVC入門)。

0

如果他們不喜歡Powerpoint,請不要使用它。我們使用Camtasia屏幕錄製功能錄製用於演示給客戶的「實況」演示(因爲它沒有在演示中途崩潰的缺點,因此可以使用引號進行演示:-)。他們總是喜歡看到它在行動,而不是他們認爲是被欺騙的功能。

它可以像您的Powerpoint幻燈片一樣暫停,並具有語法着色的優點,因爲您只需記錄將您帶入您最喜愛的編輯器。它也是動態的,比Powerpoint好得多(雖然我看到一些人使用多個Powerpoint幻燈片進行粗略動畫,總是看起來很有趣)。

這基本上映射到您的屏幕錄像想法,但是,如果您想要在那裏存在理由,請做大量小型屏幕錄像以顯示在您的真實陳述之間,如有必要,請親自陳述(不在屏幕錄像中)。個人而言,我更願意向目標受衆發送完全敘述的Camtasia,但那是因爲我並不完全凌駕於早期職業生涯中公開演講的恐懼症:-)。

在一個捏,你可以做一個真正的現場演示,因爲你的觀衆(視頻等同於視頻演示?)是程序員,並會明白你有任何問題。

0

我有這個工作對我來說,並認爲這是最佳的解決方案:

找另一個人來幫助你。當你在談論代碼時,讓助手鍵入代碼。這樣,房間裏的每個人都會看着代碼,同時聽你解釋它。

這當然包括尋找能幫助你的人,並且像你一樣瞭解代碼。但結果可能很好。

1

如果你想讓你的觀衆看到很多代碼片段,尤其是冗長的代碼片段,你可以把它們打印出來作爲講義或者以PDF或文本文件(人們可以在他們的筆記本電腦上跟隨)提供它們。

實際演示文稿幻燈片應包含傳達您想法所需的最少量文本(包括代碼)。如果有很多東西需要遠距離閱讀,一段時間後你的觀衆會感到厭倦,並且可能會遇到麻煩。讓人們在自己的筆記本電腦或講義上閱讀完整的代碼部分,同時讓您注意演示文稿幻燈片或腳本中的關鍵部分。

0

如果你可以在屏幕錄像中做到這一切,你不必在那裏,然後做一個截屏並不在那裏。沒有人會在取消會議時抱怨。只需分發視頻,或者附上附帶報告或鏈接的報告,以便人們可以閱讀有關您正在演示的工具的更多信息。

當你的同事和經理與其他人交談時,你會得到更多的信用:「嘿,你看到Bibac做了嗎?不,你應該;午餐後我會把地址寄給你。 「

如果您在演示文稿中演示代碼,那麼也應考慮讓已完成的項目可用,以便人們可以自己嘗試。

0

當我發表涉及Visual Studio的演示文稿時,我將代碼片段放在工具箱的常規選項卡上。在演示過程中,我將這些代碼片段拖放到代碼文件,標記頁等中。

相關問題