<HTML><BODY style="word-wrap: break-word; -khtml-nbsp-mode: space; -khtml-line-break: after-white-space; "><DIV><DIV>On Nov 2, 2007, at 5:25 AM, Dan North wrote:</DIV><BR class="Apple-interchange-newline"><BLOCKQUOTE type="cite"><SPAN class="Apple-style-span" style="border-collapse: separate; border-spacing: 0px 0px; color: rgb(0, 0, 0); font-family: Verdana; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; text-align: auto; -khtml-text-decorations-in-effect: none; text-indent: 0px; -apple-text-size-adjust: auto; text-transform: none; orphans: 2; white-space: normal; widows: 2; word-spacing: 0px; ">- Documentation, documentation, documentation. It doesn't have to be clever or comprehensive. Just a solid walk-through of creating an application. The answers are mostly there amongst the original videos, the cheat sheets and the tutorials. It just needs shaking down and presenting in a clear and consistent way. I would choose some "typical" users and target them. Initially target an experienced ruby programmer writing their first web app in nitro. Then something like a "nitro for rails developers" track.<SPAN class="Apple-converted-space"> </SPAN><BR></SPAN></BLOCKQUOTE></DIV><BR><DIV>The documentation is the common thread, and the cure is twofold:</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>- Yeah, write some cool new tutorial documentation. Something a person could do in a couple of hours that's more than stupid-simple.</DIV><DIV>- Find all the outdated documentation and encourage everyone who owns it to update it to current tools/standards</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>I keep looking at Nitro and Og and saying, "I want to do my next app using Nitro and Og," but they don't sit still long enough for me to build up any muscle memory. If a reasonably stable release appeared and everyone went into "no new features, no api changes, no tool changes" mode for a month or so, I believe it would help people who now feel the Nitro/Og ecosystem is a bit slippery right now.</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>The other common thread is identifying the competition: Is it Rails? Is it Merb or PLONE? Perhaps a more interesting thing to look at are these questions:</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>- What does <insert framework name here> do well?</DIV><DIV>- What pisses people off about <insert framework name here>?</DIV><DIV>- Why could Nitro/Og do these things better?</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>I'll get the ball rolling on this last bit.</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>- Rails does greenfield apps incredibly well</DIV><DIV>- Rails pisses off people who use FK constraints in their databases</DIV><DIV>- Rails has nice generators and rake tasks</DIV><DIV>- Rails routing pisses off people who have better things to debug that their routes</DIV><DIV>- Rails has good hooks for alternative template languages</DIV><DIV>- It would really piss me off not to have Haml and Sass</DIV><DIV>- Rails is dirt simple to deploy with Capistrano</DIV><DIV>- Buying extra memory for my server to run my keen new rails apps pisses me off</DIV><DIV>- Rails makes testing a snap (and includes some support in generators and rake tasks)</DIV><DIV>- Support of only Test::Unit pisses me off. I use rSpec.</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>I don't know enough about Merb or PLONE to comment on them, but I'll betcha there are some things that people will swear are great and others that expert users get pissed off over each time they bump into them.</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>I'm sorry if this seems rambling, but what brought me to Rails was that there were homegrown tutorials out there that worked. You could gem install rails and there were no gem version conflicts. You could rails foo and you got a foo app. You could script/generate scaffold bar and you got a bar thingie. Migrations only made that better. Og should be even more capable than that. The point is, everything worked. And reliably. And in pre 1.0 versions. Nitro/Og's friction has been the "one thing broken" problem that stands in the way of going straight through that AHA! tutorial experience.</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>--s</DIV></BODY></HTML>