On Sat, 18 Jul 2009, Satoshi Asakawa wrote:

> Hi all,
> 
> Updated Shoes Tutorial Note on GitHub (http://e93f3.zz.tc/1f4j) and on
> Heroku (http://eif3.zz.tc/si2f4j).
> 
> Hope you like it, ;-)
> ashbb
> 
I like the idea, and the layout is very clean.

Who is the audience for your tutorial? Do they already know Ruby, or are 
they complete non-programmers?

When I click a link on the index page, the material appears in a new
browser tab (or window). Have you considered a navigation system like the
one in Daniel Carrera's Ruby tutorial?
(http://www.math.umd.edu/~dcarrera/ruby/0.3/) That lets readers page
through the tutorial without constantly flipping back and forth to the
index. At the moment, your tutorial reads as if it is a series of
independent "episodes" rather than a connected narrative, so this may not
be a big problem.

If I were a total beginner, I'd be very confused by seeing something like 
this at page 00402_No.1_para.html

banner : Character size 48 pixels
title : 34 pixels
subtitle : 26 pixels
tagline : 18 pixels
caption : 14 pixels
para (paragraph) : 12 pixels
inscription : 10 pixels 

Is it necessary, or just something that was left over?
-- 
J. David Eisenberg  http://catcode.com/

Reply via email to