I would prefer an API Reference by section (dojo, dijit, dojox).

With and extermination of each function, all parameters, what is returned.

Then a short code example(s) of how it can be used.

The api from 0.4.3 is great! you can instantly access any code or any function you want, you shoudl use something pretty similar to this new book. Of course the examples will be perfect too and of course should be separated by sections (dijit, dojo, dojox)

Thanks

Greetings,

Pancu

The dojo book is great! But the quick installation section is missing the CDN install info(the provided link merely points back to the page you are already looking at). I'm not a newbie I'm a few weeks in but I always come here when starting a new project(and for reference). Would be great help not having to dig through the old news for it.

Rest of it's great, keep those grid examples coming! :)

Examples for all in Dojo:

-Programatically or no;
-Examples on-line linked too (as Yui);
-Documentation in english with language more simple as possible (even if the words are repetitive), to facilitate the reading of users with less experience in english and facilitate future translations.

Thanks,

Rodrigo

IMHO, I would like to see a more extensive API reference, with more examples and cross references to the Dojo book. The Dojo book should be more like a "first steps" with Dojo, as it is today, but it can always be interesting with more examples in it too.

While the documentation is improving, it's far from perfect. I'm relatively new to Dojo and have not fully committed to it because so much is left to trial and error. I've found that there are almost no programmatic examples or documentation and what does exist are only partial examples - nothing that can be quickly cut and pasted in order to play. Declarative examples are more plentiful, but some don't run under IE 6 or 7 (i.e. the Mail Demo on the demo page). Since almost no commercial documentation is available at this time, this site is pretty much the only source of information. Full API and bullet proof examples that work in all browser are needed.

Most adopters need the API AND examples in BOTH forms: Declarative and Programmatic. It's always nice to start with a working script and the adapt it to your application. Anything that can be done using the declarative approach, should be repeatable using the programmatic approach - so show both.

It would also be useful to see screen shots taken in all of the major browsers in order to see what is expected. This process would also assure that the code actually works in all browsers. I'm still seeing many things that don't work in IE. Since I can't control my users browser selection, I need know how a feature is going to work across all platforms.

Fully annotated/commented examples please. Year's ago I had an instructor who thought every line of code should have at least a comment and major sections should have a paragraph explaining what's suppose to be happening and why. Too many programmers shortcut this process in the production environment, but it's an essential step for documentation that is intended for a wide audience. Don't assume a certain level of knowledge. Everyone starts out with no knowledge and builds from there. The examples should be documented with sufficient detail that a beginner can understand the thought process without having to call for help.

Finally, I could envision a "Learning to Program with Dojo" document for the absolute beginner. This document could teach "best practices" and cover some of the more common techniques needed in order to build a simple website application using Dojo. This document could be a step by step tutorial for those just learning to program. It doesn't have to be a huge example. After all, in programming there are really only a few techniques that are repeated over and over again. Most books of this sort teach how to build a page with a menu and perhaps dynamically update a page from some data source. Perhaps a simple form with a Add/Modify/Delete example updating a database table would be useful. This idea of this document is help the student exercise most of the Diji controls for the first time.

Those are my thoughts. Thanks for asking.

I'm new to Dojo and have since shared the site with some of my other developer colleagues looking to spice up their next web project. I'd sure like to see some of the following in the new Dojo book:

a) Reference API:
- by full object name (with namespace): defined sections for properties, events, methods, styles
- fully working example code listing for the api being addressed: with popup to execute and demonstrate (wouldn't that be something?)

b) How-to articles: would be nice if this is initially provided by Dojo team and then with some protocol in place for contributors to keep it growing.

c) Please, more documentation on rolling your own dojo widget (from scratch and by composition with existing widgets): I'm now trying to do a three state checkbox and it's been though going. I'm surprised that there's not already an existing one out there--well at least it is not published.

Great Job! I love the book and direction it is taking.

My only complaint is that the pages with real examples do not work in IE7 (Vista or XP).
Get: Internet Explorer Cannot open the internet site Operation Aborted.

Is everyone with IE7 having the same results?