At SitePen, we've just added a new Dojo QuickStart Guide. This guide was developed by the SitePen support team.
Dojo QuickStart Guide
Submitted by dylan on Fri, 04/25/2008 - 05:34.
- dylan's blog
- Login or register to post comments
- Unsubscribe blog
- Unsubscribe post
Good intro! I came across a
Good intro!
I came across a correction working thought the examples:
In 'Some Gloss: Dojo Animations' the 'dojo.fx.combine' exmaple isn't working. Also, the page footer overlaps the content on this page in FF2, which doesn't look so 'Pro'.
Also, some of the links into the Dojo Book seem to be returning blank pages for some reason and some of the other links to external pages. Might be worth giving all the links a quick once over.
Otherwise it has cleared things up a lot in my head. Its also good how the earlier examples are reused in the later so one gets a feeling of how it all fits together. Perhaps if the whole tutorial was about building one thing that used all the parts it would be more... "whole" in a way.
Anyway, keep em comming, Dojo rocks!
/^\*/^\*/^\*/^\*/^\*/^\*/^\*/^\*/^\*/^\*/^\*/^\*/^\*/^\*/
Suffering from Too Much Information
Good catch on the combine
Good catch on the combine example, I'll fix it up right away!
I'm not seeing the Same FF2 footer overlap? Windows or MacOS? I'll be the first to admit the layout is done with some trickery, but I had tested it thoroughly in FF2/3/Safari/IE6+7 ... For what it's worth, the whole page is "standard html", and the layout is done after the fact. I'm writing a blog on "how" that's done as we speak, so perhaps that will expose whatever issue that is.
We thought about giving it a "tutorial like" direction, but opted for "explain all the basics in one place", doing our best to tie the ideas together. There simply is "too much Dojo" to clearly and concisely explain all that we set out to clarify for newcomers without overloading them with specifics of back-ends and direct use-cases. Trying to keep it as general as possible, and still chock-full of vital information.
So it illustrates how neat
So it illustrates how neat this method of doc-writing is (the point of my coming blog). The combine error was simply a missing namespace: dojo.fx.slideTo rather than dojo.slideTo. Added .fx, svn commit the code snippet (they are all external files), and it is automatically reflected in the flat file. It should be fixed now, and again thanks for the report.
It's important to note we _want_ those kinds of reports to ensure the guide stays accurate and up-to-date for all Dojo users, and need the feedback to ensure as much.
With regard to the links breaking ... They all do in fact work, they are tested in an automated fashion (another side effect of the doc-method), though on occasion pages on dojotoolkit.org will do that "White Screen of Death". It is a php-accelerator issue the admins are trying to work out, but thank you for the feedback regardless.
Regards,
Peter Higgins
Hey, If you guys do want
Hey,
If you guys do want similar feedback then perhaps you'd better provide a simple way for people to give it. The only reason I did was because this article was still on the front page of Dojo. On the actually article page there is no feedback interface. The book pages here offer comments if the user is logged in, I don't know if you guys catch all the feedback from there?
On a side note, I did a search for "dialog" in the API reference and got this message: "Access denied You are not authorized to access this page." The API seems a little think as well. Is it finished?
We're going through some growing pains.
...particularly in the past few days; you must have caught this yesterday when we were trying to figure out why we keep getting the "white screen of death".
I'll do a quick blog post about it so that it's actual news but in the meantime if you could be just a little patient, we'd be pretty grateful.
Soryr mate, didn't mean to
Soryr mate, didn't mean to sweat ya ;-)
Oh That's just Tom ;) I've
Oh That's just Tom ;)
I've prototyped a widget that will provide feedback functionality in the guide pages directly. A progressive enhancement that simply adds a button and container dropdown to the page that stays affixed in the margins. As soon as the style guru's slap some pretty on it, it should be good to go.
Thanks for the direct feedback suggestion, sometimes is hard to see the forest for trees ...
QuickStart Guide
QuickStart Guide is a good idea. I also did not find an FAQ. Is ist also avaible? (sorry about my english)