Document 360: #1 Knowledge Base Software
Stay updated
Keep current with the latest trends in technical communication by subscribing to the I'd Rather Be Writing newsletter. 5,400+ subscribers

SwaggerHub: The Platform for Designing and Documenting APIs with SwaggereasyDITAHyperSTE checker softwareAdvertising optionsMadCap Central 2020 ReleasePaligo: Technical Documentation Software with Powerful Content Re-useTWi: Leading Provider of Documentation and Technical Communication Solutions

Document 360: #1 Knowledge Base Software

How Do You Teach New Users Programming?

by David CHEN on Apr 19, 2013 •
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.
Sponsored message:
SwaggerHub was built by the team behind Swagger to help organizations collaborate on their API design and documentation from one centralized platform. Find out why SwaggerHub is the platform for design and documenting APIs with Swagger. >Get started for free.
follow us in feedly

SwaggerHub: The Platform for Designing and Documenting APIs with SwaggerMadcap Flare