Re: [Dojo-interest] [ANN] 0.4.0 is released!

Adam,

We're working on a 2-pronged strategy for fixing the doc problem. As you 
may know, we've recently launched the API reference:

        http://dojotoolkit.org/api

The second prong, and the one you seem most interested in, is taking 
shape in the form of "the Dojo Book". It's a collaborative effort to 
build a set of comprehensive tutorials, explanations, and overviews 
that will give you everything you need to be successful with Dojo. It's 
taking shape right now over at:

        http://manual.dojotoolkit.org/DojoDotBook

It's still a work in progress, but it's improving day by day and will be 
in it's first "shippable" state for the 0.5 release, scheduled for 
early next year.

We realize that folks are frustrated, but in every sense that matters 
we're running as fast as we can to catch the documentation up with the 
code. If you'd like to be a part of that, send me private mail and I'll 
see to it that you get connected with the right people.

Regards

On Friday 27 October 2006 7:45 pm, Adam Fisk wrote:
> I know you're all aware of this issue, but I think Andrew brings up a
> vital point about documentation.  The fact that conversation became
> so heated so quickly only underscores the gravity of the situation. 
> I agree it's completely ridiculous to have to download files and open
> them to discover the differences.  Are you joking?  The snippy
> comments are unnecessary, but the guy has a point.
>
> I'm not exactly a rookie when it comes to software development, and I
> find Dojo to be one of the most confusing projects I've ever
> encountered.  I feel confident Dojo is the best JavaScript platform
> in the world today, but I'm not exactly sure why because the few
> chances I've had to really get it fired up have hit against one too
> many barriers, and I've gone back to higher priority work.  Still,
> I'm not even a Dojo user, but I've been checking every other day to
> see if the new version is out.  I don't do that with any of the
> platforms I actually use!
>
> I know everyone is aware of this, but I'm not sure the urgency of the
> situation is fully understood.  I think lack of documentation and
> tutorials is the #1 problem with Dojo.  I think many of the users in
> the community are outraged.  When your users are outraged, that's
> about as bad as it gets. Your community is all you have, particularly
> for open source projects.  That 15,980 number is fantastic and
> laudable, but I honestly think it would be more like 60,000 if the
> documentation were impeccable and the code the same.
>
> I say this out of the greatest respect and in the interest of the
> best possible future for Dojo.
>
> -Adam
>
> On 10/27/06, Alex Russell <alex@xxxxxxxxxxxxxxx> wrote:
> > Just as a quick update, in the 4 days since the release, Dojo 0.4.0
> > has been downloaded 15,980 times. Everyone who pitched in should be
> > proud not only of what we accomplished in the release, but also by
> > the reception it's received. Great work everyone!
> >
> > Regards
> >
> > On Monday 23 October 2006 11:16 pm, Alex Russell wrote:
> > > Hey everyone,
> > >
> > > A quick note to let you know that you can grab your favorite
> > > profile builds of Dojo 0.4 from:
> > >
> > >       http://download.dojotoolkit.org/release-0.4.0/
> > >
> > > Adam blogged it in more detail:
> > >
> > >       http://blog.dojotoolkit.org/2006/10/23/dojo-04-is-here
> > >
> > > And the release tracking page that Bill has been maintaining is
> > > at:
> > >
> > >       http://dojo.jot.com/Release0Point4
> > >
> > > Congrats to everyone who pitched in to make this happen. While
> > > we're looking forward to 0.4.1 very shortly, 0.4.0 delivers new
> > > capabilities that are going to allow our users to push the web
> > > forward. Everyone who worked on this release should be proud of
> > > what we've accomplished.
> > >
> > > Regards
> >
> > --
> > Alex Russell
> > alex@xxxxxxxxxxx     A99F 8785 F491 D5FD 04D7 ACD9 4158 FFDF 2894
> > 6876 alex@xxxxxxxxxxxxxxx BE03 E88D EABB 2116 CC49 8259 CF78 E242
> > 59C3 9723
> >
> >
> > _______________________________________________
> > Dojo FAQ: http://dojo.jot.com/FAQ
> > Dojo Book: http://manual.dojotoolkit.org/DojoDotBook
> > Dojo-interest@xxxxxxxxxxxxxxx
> > http://dojotoolkit.org/mailman/listinfo/dojo-interest

-- 
Alex Russell
alex@xxxxxxxxxxx     A99F 8785 F491 D5FD 04D7 ACD9 4158 FFDF 2894 6876
alex@xxxxxxxxxxxxxxx BE03 E88D EABB 2116 CC49 8259 CF78 E242 59C3 9723

pgpwGbyaofpaA.pgp
Description: PGP signature

_______________________________________________
dojo-contributors mailing list
dojo-contributors@xxxxxxxxxxxxxxx
http://dojotoolkit.org/mailman/listinfo/dojo-contributors