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

TWi: Leading Provider of Documentation and Technical Communication SolutionsMadCap Central 2020 ReleasePaligo: Technical Documentation Software with Powerful Content Re-useHyperSTE checker softwareSwaggerHub: The Platform for Designing and Documenting APIs with SwaggerAdvertising optionseasyDITA

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:
Over 40,000 API developers use SwaggerHub to design and document APIs with Swagger (OpenAPI). Learn how SwaggerHub can help improve your team’s API documentation workflow. >Get started for free.
follow us in feedly

Madcap FlareSwaggerHub: The Platform for Designing and Documenting APIs with Swagger
Your Commento.io account has been suspended. Go to the Commento dashboard to resolve this.