如何做一个介绍对你的同事含有大量的代码？[关闭]
https://stackoverflow.com/questions/454321
-
19-08-2019 - |
italiano
english
français
española
中国
日本の
العربية
Deutsch
한국어
Português
Russian题
我应该做一个介绍对我的同事在网框架内我进行评估。这些人是开发商和长仇恨和无聊的PowerPoint的东西，所以我有很多小代码段。我还把一个小样本应用程序。我的问题是，如何做我本代码，以便人们可以遵循？
有些事情我想到:
- 把代码的PowerPoint幻灯片，看起来很坏的，除非它是一个像我不能让语法突出的工作。有我的代码图像是一个痛苦和无法扩展以及不同的决议。
- 我打了围绕与S5XHTML介绍格式和综合JavaScript法荧光笔。这是一个有点笨重但是可行的(我会得到一些悲伤忽视了该公司的CI的介绍，因为我不会用他们的模板。不要问...)
- 我可以把一个剧本(注释)和"生活代码"在我面前的观众。我不喜欢这个那么多，因为它让我这么忙，我很难得到一个很好的解释，同时我写的。还有一个高机会对我造成的错误和使他们等待。
- 一个视频?但是然后我就不会在那里...也许叙述呢？
所以你会怎么做？
解决方案
我可以把一个剧本， "生活代码"在我面前的观众。我 不喜欢这么多，因为它 让我这么忙，我很难 得到一个很好的解释虽然我 写。还有一个高的机会 我造成的错误和使他们 等待。
我喜欢这个选择，如果你能得到你演示简化的要点不持有的观众。你可以做什么电视厨师做的时候配方需要更多的时间比他们拥有；启动的编码,然后跳跃前进的一个90％或100％完成。
如果你有一位同事，你可以得到了速度快，你可以让他们做的编码时你说话，指出他们在做什么。
你可以用你的IDE，这将给法突出和显示你的观众如何编制、部署、测试等。我会推荐使用大号字体虽然只是为本届会议，所以，每个人都可以看到。
其他提示
你IDE允许开/闭区域或码段？在Visual Studio你可以创建区域代码，可以展开或崩溃。如果你IDE有能力这样做，你可以为你代码样本作为地区，然后开/闭他们正如你通过你的介绍。你可以开关之间来回你的演讲和代码样本在IDE,但不代码。使用开/闭可以隐藏的代码你不引用让事情更少混乱。
我确实看到过这样做，在敏捷2008年，它似乎运作得很好。
你可能只适合那么多的信息上的PowerPoint幻灯片但是，实际上是一个良好的事情：人们只能看一定数量的信息和获得什么有意义的。
所以如果你可以不适合它的PowerPoint幻灯片，你需要重新考虑你的方法。
代码段是好的。他们不需要加以强调。只是把它们放在快递新的(或者某些其它固定宽字体)，它就会遇到的代码。代码段没有完成。只要煮他们的基本概念(用的意见或省略号表明缺少代码)。
程序员正在程序员，他们可能会问的问题时，它得到的技术，这是很好的。
此外，如果该程序员都熟悉一些类似的尝试，并涉及所有的概念，回到他们知道些什么这使它更容易掌握。如果你是在说明春视和他们知道的支柱，解释本支柱当量。它可以是有用的，把这种事情以表格形式(即使作为一个讲义).
这就是我做了什么为准确，(一个软弹簧引为支柱的程序员).
如果你想要你的观众看到很多代码段，特别是冗长的，你能打印出来作为施舍或提供它们作为注意到在PDF或文本文件(人可以跟着他们的笔记本电脑).
实际的幻灯片演示文稿应包含最少量文字(包括代码)必要的表达你的想法。如果有很多读的距离，你的观众将获得累了一段时间后，可能有麻烦以下。让人们阅读完整码的部分在他们自己的笔记本电脑或者施舍，同时呼吁注意到仅有的关键部分在你幻灯片或脚本。
如果他们不喜欢的Powerpoint，不要使用它。我们使用Camtasia屏幕的录音记录"现场"演示对介绍的客户(生活在报价，因为它没有缺点的崩溃，半路过你的演讲:-).他们总是喜欢看到它在行动，而不是什么他们认为是捏造的功能。
这是暂停，能够像你的Powerpoint幻灯片和具有优势的语法色彩，因为你只是记录带来了你在你最喜欢的编辑。这也是动态的，这是更好的比Powerpoint(虽然我已经看到有些人做的动画粗多的Powerpoint幻灯片，总是滑稽看在行动)。
这基本上映射到你的屏幕想法但是，如果你想有一个原因是那里，做大量的小视频显示之间穿插你的真实的介绍，叙述(中的人,不在屏幕)如果必要的。
我个人愿意送一充分叙述Camtasia关于目标受众，但这是因为我完全不在我的职业生涯早期恐惧症的公共演讲:-).
在一个紧要关头，你可以做一个真正的现场演示自己的听众(是videance相当于用于视频演示?) 是程序员，并将了解的任何问题。
我有这个对我做的，并认为这是最佳的可能解决方案：
获得另一个人来帮助你。而你正在谈论的代码，我们的辅助类型的代码。这样每个人都在房间将寻找的代码，同时听你解释。
这当然涉及到找到一个人可以帮忙，明白的代码只是为你做的。但是结果可能是巨大的。
如果你能做这一切视频和你不会已经到那里，然后做一个视频，并不存在。没有人抱怨，当一个会议被取消。只是散发视频、可能与附的报告中注意到或链接，使人们可以了解更多关于该工具你证明了.
你会得到更多的信贷，后来作为你的同事和管理人员跟其他人："嘿，你有没有看到呈现Bibac没有？没有？你应该;我会送你的地址后午餐。"
如果你证明代码的演讲，然后还要考虑具有完成的项目可以使人们可以试试自己。
当我介绍涉及Visual Studio我把代码段的一般性标签的"工具箱"。在介绍我把/拖这些代码段进入一个代码文件，标记页面，等等。
