I didn't see a forum or email for discussion Dojo documentation? I have been reading at this web site .... see here for example:

http://dojotoolkit.org/book/dojo-book-0-9/part-1-life-dojo/example-1-why...

Is it just me or is api.dojotoolkit.org redirecting to alex.dojotoolkit.org (which is no api as far as I can tell)?

Hi,

I am getting a little tripped up using Dojo and I realized that my problem is that I am using version 1.1.1 but the Dojo Book is for 1.0 and the API documentation is for version HEAD. I downloaded the source for version 1.1.1 to see if there was any updated documentation but could not find anything. Is there are snap shot of the api documentation for version 1.1.1?

Thanks
Arend

I’ve been pondering a few ideas relating to the build and jsdoc systems. I’m just sharing the early concepts here for open discussion, if anyone else is interested. Thanks to James Burke for providing insights on the current build system and pointing me in the right direction.

The Ideas:

I've been taking apart dojox.gfx in order to see how it works, and really felt the need for a good documentation generator that would grok dojo-centric JavaScript. Apparently I'm not the only one who would like such a tool, as I found this post by Alex Russel from 2006:

http://dojotoolkit.org/pipermail/dojo-interest/2006-March/005423.html

Did this project get anywhere?

Jake

The Dojo API seems like it is autogenerated by some tool from comments in the source code.

Is this a facility that we can use for our own modules and namespaces? If so, can I get a tip or pointer on where to find documentation on how to do so... I haven't been able to find it so far.

Thanks very much.

---Scott Jenkins

I was fiddling with the DnD example in the doco:

http://dojotoolkit.org/book/dojo-book-0-9/part-3-programmatic-dijit-and-...

and got it working after a little tweeking. Then noticed a strange but regular bug with it. I goes like this:

1. Drag an item to the 'Your Shopping Cart' target.
2. Try and drag this item back to the 'Todays Special' target

I was just going though the DnD code in the Book and came across a Dojo function I didn't know about and was about to look it up then thought that it would be really cool if a little summary (or even a big one) from the API documentation would appear if I kept my mouse over the function name in the code insert. Would be handy in the API doc as well and with Drupal not such a biggy to make happen really.

Just a thought ;)

I could not find a forum appropriate for this suggestion, hope it's close enough to on topic.

The api.dojotoolkit.org site is painfully slow, and it's also doing way too much work. This slow performance I first thought, was due to dojo code -- Not so. It's due to PHP inhibiting caching.

There's an easy fix. You need to enable caching! See http://www.mnot.net/cache_docs/ and there's some very specific help for PHP:


<?php
Header("Cache-Control: must-revalidate");