Stay current with the latest in tech comm
Keep current with the latest trends in technical communication by subscribing to the I'd Rather Be Writing newsletter. 5,000+ subscribers

Stitcher radio

Search results

I'm giving an API documentation workshop in Mountain View, California on August 30, 2019. If you're interested, you can register on EventBrite.

How Do You Teach New Users Programming?

by Tom Johnson on Apr 19, 2013 • 0 Comments
categories: api-doc

I've recently fallen in love with a site called Code Academy, which juxtaposes a real-time programming console with instructions and activities. It's the most hands-on, interactive site I've come across, and I want to someday model my own help to be like it.

Here are a few key points:

  • Users learn by doing. Each concept has an associated activity with it that reinforces the concept through the activity.
  • The concepts have to be somewhat simple and concrete in order to demonstrate them through a hands-on activity.
  • Implementing a similar site would require help from a programming team.
  • Similar to the Let Me Try simulations, if you don't program the code exactly as it should be, the system sometimes thinks you did it wrong.
  • The instructional column is somewhat limited in the depth it can cover. Sometimes I'd like to just read a few paragraphs or pages on the topic.
follow us in feedly