[Nitro] Newbie Impressions
mattrose at folkwolf.net
Tue Jun 12 17:35:03 EDT 2007
I'd be in on that. I've done some diving in the code, but I've
actually pretty much given up on nitro because of the lack of
documentation, so I'm a little rusty.
On 12-Jun-07, at 5:31 PM, Arne Brasseur wrote:
> Jonathan Buch schreef:
>> [18:10] <ekim\> Is there some kind of "getting started" guide for
>> [18:10] <ekim\> the documentation seems to be very sparse
>> [18:11] <Jo[work]> yes, docs are sparse and often outdated, which
>> is sad
>> [18:11] <Jo[work]> have you seen http://oxyliquit.de/ ?
>> [18:11] <ekim\> are you just suppoed to "Know"
> This is definitely a sore point for Nitro. I would like to help to
> create some sort of manual by the time 0.5.0 is released (which
> won't be tomorrow anyway). I'm still quite new to Nitro but I try to
> regularly read some source and try to make some notes as I go along.
> Jo and I talked about it a bit on IRC and he pointed out the Django
> (http://www.djangoproject.com/documentation/). We could follow a
> structure with a step-by-step guide for newbies followed by a complete
> reference section. I'm thinking a wiki-like system for the editors,
> freeze the text when it is released after which only comments can be
> made (like with postgresql/php docs).
> Ideally each section would contain it's own unit tests to see if the
> examples are still valid with new versions, altough I think at this
> point it is more important to focus on actually getting some docs
> Other opinions on this? Any source diggers willing to contribute?
> thank you
> Arne Brasseur @ your service
> arne at arnebrasseur.net
> Nitro-general mailing list
> Nitro-general at rubyforge.org
More information about the Nitro-general