Reviewer guide

Speak concisely

By now, you know the drill: egghead lessons are short and to the point. That goes for the videos, which should be 1–10 minutes long. It also goes for your narration. Less is more.

Consider this example:

Hello! Before we get started using Webpack you are going to need to install node. We are going to visit this URL and find the link to install it. Now we press "download" and we should get a file. We can now open that file and extract its contents. Now that node is installed, we can use npm to install webpack globally. Great. Now that webpack is installed globally, we can use it! Open up Sublime or your favorite editor to start working on the config.

Holy backstory! If you think back to our cheesecake-stuffed cookie cake example, we don't have to explain or justify each step in the instruction. We can assume we’re delivering content to smart, capable humans who can fill in some blanks. We have to. There’s instructing to do, and the clock is ticking.

Without the over-instruction, we have a much more concise, energetic start to the lesson.

We've got node already installed. Use npm to install webpack. Now run init and open the config to edit it.

Note how active those sentences are: install webpack. Run init. Open the config. Those are instructions.

How much personality can we bring to our lessons?

Bring all your charm and favorite idioms to your narration as long as they support your code example. That’s what egghead learners come to see: good code. Use the “show your work” trick to determine if you should talk less, code more.

read next

The show your work trick