As part of my new responsibilities at Amazon, I’m working to re-write the Alexa development tutorials for a couple of reasons:
- We want them to be as easy to follow as possible for developers of all skill levels.
- The Amazon Developer Portal and AWS will forever be making changes to their interfaces, and we want to be able to easily keep up with updating our screenshots.
- We want to be able to re-use as much of each tutorial as possible, again to minimize the maintenance costs that come with updates.
Before anything else, however, we want tutorials that help developers get from Point A (no Alexa skill) to Point B (published Alexa skill) with as few barriers as possible.
So I ask these questions of you, my wonderful readers:
- What are some examples of tutorials that you have found effective?
- Which is the best format for you to follow a tutorial?
- One long web page that covers every step.
- One web page that covers the essential steps, but has links to the “fringe-y” stuff that only some developers will require.
- Multi-page tutorial that breaks the process into 5-6 digestible chunks.
- A video.
- Is it more important to get to Point B, or understand *how* you got there?