Rules for Teaching, eLearning, Tutorials

  1. Examples should be real world, relevant, practical.

For example, if you’re teaching someone how to visualize data using JavaScript–and using, say, D3 for example, it’s rather useless to only use data that’s embedded right there in the HTML doc or the js file right next to it because, in the real world, nobody is going to do that. They will, rather, access external resources such as a database or a JSON file.

In searching for resources to meet this need I’ve found four things:

  • Tutorials that show the code referring to, but not showing, the JSON file and its contents
  • Comments, replies, etc. asking if there are any tutorials that show the content of the JSON file as well
  • Tutorials that show the JSON code but not the html/javascript code
  • Comments, replies, etc. asking if there are any tutorials that show both

This is the same sort of nonsense I ran into countless times while trying to learn how to make an html form talk to a MySQL database via some PHP code.

Another frustration is everyone jumps from one library to another so I’m not sure (yet) if I’m looking at jQuery, plain JavaScript, or some arbitrarily named function/variable. That’s what happened with the forms/database nightmare and it’s happening with this D3/JSON business that, all things being equal, should be a freaking leisurely stroll through the forest populated only by single, lonely, horny elf-princesses.


About jotascript

Aiming to please. Seeking to impress.
This entry was posted in elearning, Frustration, Teaching. Bookmark the permalink.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s