46 Line Blog Docu is not working as is

[Andreas Schaefer <sc...@me.com>]

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

Re: 46 Line Blog Docu is not working as is

[Bertrand Delacretaz <bd...@apache.org>]

Hi Andreas,

On Tue, Jan 26, 2010 at 2:34 AM, Andreas Schaefer <sc...@me.com> wrote:
> ...This is a long list for the first and only tutorial on the Sling project and most
> likely will disgruntle many developers evaluating Sling...

Thanks very much for reporting! I'm busy testing a Big Release at work
these days, but I hope to be able to switch to "fix those docs and
samples" mode soon, and fix those problems (unless someone beats me to
it).

-Bertrand