Hacker News new | ask | show | jobs
by dylanks2 5050 days ago
Check out the new docs. I think it's no longer reasonable to say Dojo lacks good docs or reference code.

Marketing is challenging for engineers. We tend to not go crazy over every small feature, but focus on the big stuff. That said, we're improving our approach.

1 comments

The tutorial section looks much improved over previous visits - good job.

Two points:

1. The tutorial shows using the CDN, then there's big warnings saying "don't do this in production". Give another demonstration of the "highly recommended" approach vs leaving people to piece that together themselves.

2. "we tend to not go crazy over every small feature". What's a small feature to you may just be something that 80 people have been waiting patiently for. While you can often judge what a 'big' feature is by your standards, dismissing many other things as 'small' probably misses a lot of people.

Point 1. is indeed a "uncomfortable" part of dojo. Getting started is difficult. For a lot of demo and hello world like apps CDN version is fine, assuming they are only using the modules packaged into dojo.js on CDN. If you start using other modules, then you will soon see a escalating number of HTTP requests, and for this reason using CDN version for production is bad idea.

Its just not that easy to get started with and get a sane production build from dojo yet. Hope all of this will change by the time 2.0 is out.