Tiago Garcia @ Avenue Code
Feb 11th, 2014
- The template
- Installing
- Working
- Deploying
- Your talk
- Organization
- Content requirements
- Communication requirements
- The DONT's
- Tips
- If you are recording
- Contributing
- Learn more
- Conclusion
- Assignment
- Markdown
- Reveal.js
- Grunt
- The Avenue Code talk template is a responsive, web-based talk template.
- This template is based on Reveal.JS.
- All you need to do is to write your content in Markdown.
- There are some Grunt jobs to automatize the build process.
- It has automatic code highlighting, guessing the programming language you used.
- Once it is described in README.md, the talk contents will also be available as the repository description which is a common format for tutorials.
- Sign in on GitHub
- Fork the repository https://github.com/acbr/talk-template
- Rename it to match your talk name (ex: talk-design-patterns)
- Clone this repository
- Navigate to its folder on the terminal
$ npm install- Build it, serve it and monitor source files for changes
$ grunt- Open http://localhost:8000 to view your talk
- Open up config.json and fill your talk data such as title, author, email, date and description.
- That is the ONLY FILE you should edit on the project root!
- Any further change you will do is inside the src folder, such as:
- src/README.md to write your talk content in Markdown
- src/index.html to modify the HTML
- Grunt will generate files on the project root as you change src.
- In order to separate slides horizontally, use 3 dashes (---).
- In order to separate slides vertically, use 4 dashes (----).
- In order to call out attention, put an asterisk around your text:
In order to *call out attention*, ...
- Make sure your build is not breaking.
- You should see Done, without errors. in the terminal.
- git add, git commit and git push to gh-pages branch.
- You should see your talk in an address like:
- http://your-github-username.github.io/your-repo-name
- Ex: http://acbr.github.io/talk-template
- Should last no more than 50 minutes, leave up to 10 minutes for questions.
- Should not be too deep neither too superficial.
- Give at least 3 reference links to be followed for further studies.
- Give a challenge that would be solved using ideas that were covered on the talk.
- It is ok to go a little bit far (forcing the attendee to do some research), but that should be optional.
- 1st slide: the cover, featuring your talk name, your name, the lecture date and AC logo.
- 2nd slide: the agenda, in topics.
- 3nd slide: the prerequisites of your talk.
- From 4th slide on: your content
- When content from the same topic doesn't fit on a slide -> grow it VERTICALLY by adding a slide below (----).
- When you finish a topic and will start a different one -> grow it HORIZONTALLY by adding a slide to the right (---).
- The 3 last slides: Conclusion, Learn more (with the reference links) and Challenge.
- BE CONSISTENT. Master the subject and do not contradict yourself.
- CATCH THE ATTENTION. Let the audience know WHY they cannot live one more day without this technology.
- BALANCE THEORY AND PRACTICE. Your target is keeping the subject interesting for everybody.
- BE CONCISE. Don't overexplain in such way you could cause confusion to your attendees.
- KEEP THE FOCUS. Off-topic discussions are ok, but only if it doesn't disturb the natural flow of your content.
- BE PREPARED. If you are going to use examples or live coding, make sure you have them all prepared beforehand.
- COMMUNICATE WELL. Be sharp on English, no bad words or slangs and use the best words for the audience.
- BE A PRO. Please watch some good screencasts in order to learn how to use your voice and conduct the talk.
- BE POLITE. Be respectful and avoid heavy criticism.
- BE PROFESSIONAL. Use jokes and humor with parsimony.
- TRAIN your full talk at least once before your talk.
- DO NEVER SHOW PRIVATE CODE FROM THE CLIENT. This is CRITICAL and can cause serious problems.
- DON'T BE ARROGANT. Be humble and don't focus the talk on yourself.
- DON'T GENERALIZE, specially stuff that you are not sure about.
- DON'T MAKE UP DATA. Base yourself on trustable references.
- DON'T TALK LIKE A ROBOT. Just be yourself, natural. Relax :)
- ENJOY your experience by creating the talk, because you will surely learn MUCH MORE than your attendees.
- BRING WATER to drink while you present. You will certainly need it!
- BE OPEN to receive questions and even criticism. You will learn a lot from them.
- ALWAYS be polite when talking to your audience. This will always open doors for you.
- People might come to you with questions and more complex cases after your talk. Consider it as a gift, it means you represent something good for them!
- Make sure you use a professional microphone when available.
- Don't do drastic transitions on your screen, as the recorded amount of frames per second is low.
- Ask atendees to only make questions on the end - so future watchers will just get the real content without interruption.
- Introduce yourself: "Hello everybody, my name is xxxx, I work for Avenue Code and today's talk will be about yyyyy". Finish it like: "That's it, thanks for watching.".
- Problems with recording/connection? Always restart from the beginning of the slide. Don't try to restart from where it fails, its impossible to do a clean cut on the video after that.
Should you wish to contribute, please be welcome to!
- Fork the repository https://github.com/acbr/talk-template
- Create a feature branch for your contribution
git checkout -b my-new-feature- Commit your changes
git commit -am 'Add some feature'- Push to the branch
git push origin my-new-feature- Create a Pull Request
- This talk template rocks!
- Your life should be easier now.
- Make your awesome talk based on this template.
- Push it to a gh-pages branch on your GitHub account.
- Share the URL with the world!