When I wanted to evaluate Sling I started with the 15 minute introduction to 
sling. Even though I gave some insights it was more confusing that it helped. 
So I went ahead and had a look at the 46 line blog. But that does not work at 
all because many crucial hints are missing and some parts just don't work with 
the latest version.

1) the footnotes does not work (I finally found them on the original article)
2) the article forgets to mention that the "path-based-rtp" sample project must 
be installed first. I actually had to stumble over the espblog read me file to 
figure that out.
3) the article forgets to mention that the example does not work with Safari 
(and I guess any code changes altogether) on the Mac. Firefox does work, 
through.
4) Sling.wizard() call does not do anything meaning I cannot find any existing 
nodes.

This is a long list for the first and only tutorial on the Sling project and 
most likely will disgruntle many developers evaluating Sling. From personal 
experience I know that most developers don't like to write documentation but I 
think that piece is really crucial.

Cheers - Andreas Schaefer

Reply via email to