[RDBO] Streamlining documentation

2007-05-18 Thread Marvin Humphrey
Greets, I've been tasked with learning Rose, so this is my one chance to approach the documentation naively. My first impression is that it seems admirably thorough but encumbered by well-meaning excess in places. Much of the documentation begins with scene-setting. For instance,

Re: [RDBO] Streamlining documentation

2007-05-18 Thread Marvin Humphrey
On May 18, 2007, at 9:00 AM, John Siracusa wrote: Since those sections are clearly labeled and there are links to all the major sections (in the HTML version of the POD, that is), I don't think it's too onerous for those people that want to skip them to do so. Skip the introduction? You

Re: [RDBO] Streamlining documentation

2007-05-18 Thread John Siracusa
On 5/18/07, Marvin Humphrey [EMAIL PROTECTED] wrote: On May 18, 2007, at 9:00 AM, John Siracusa wrote: Since those sections are clearly labeled and there are links to all the major sections (in the HTML version of the POD, that is), I don't think it's too onerous for those people that want to

Re: [RDBO] Streamlining documentation

2007-05-18 Thread Jud
I'm actually a big fan of the docs the way that they are, and a bit of a gentle introduction is a nice departure from the extreme brevity of most open source docs. I certainly didn't find that the few paragraphs of introduction interferred with my ability to absorb the material in any way! If

Re: [RDBO] Streamlining documentation

2007-05-18 Thread Jonathan Vanasco
Sure, but since the tutorial is the only piece of non-reference documentation, I tried to spell out as much as I could. Obviously, one document can't satisfy everyone. (I've also had people tell me the tutorial is too terse and needs to be expanded! :) I think there's a place for a

Re: [RDBO] Streamlining documentation

2007-05-18 Thread John Siracusa
On 5/18/07, Jonathan Vanasco [EMAIL PROTECTED] wrote: John- Maybe you could do a callout for recipes, and then cull the best into it? It's on the list, but not at the top just yet. (Even just collecting and editing recipes takes time.) If someone else wants to head this up, let me know. The

Re: [RDBO] Streamlining documentation

2007-05-18 Thread Derek Watson
It's on the list, but not at the top just yet. (Even just collecting and editing recipes takes time.) If someone else wants to head this up, let me know. Is there a Wiki installed somewhere we can start working on in an ad-hoc fashion?

Re: [RDBO] Streamlining documentation

2007-05-18 Thread John Siracusa
On 5/18/07, Derek Watson [EMAIL PROTECTED] wrote: It's on the list, but not at the top just yet. (Even just collecting and editing recipes takes time.) If someone else wants to head this up, let me know. Is there a Wiki installed somewhere we can start working on in an ad-hoc fashion?

Re: [RDBO] One-to-One on unique key

2007-05-18 Thread Derek Watson
That's a pretty cool approach, and it solves adding a new record smoothly. But what it misses is the ability to fetch all a that have a non-archived b: SELECT * FROM a JOIN b ON (b.a_id=a.id) WHERE b.archived_at IS NULL or My::A::Manager-get_as_iterator(requre_objects = [ 'b' ]); Here's another

Re: [RDBO] Streamlining documentation

2007-05-18 Thread Ask Bjørn Hansen
On May 18, 2007, at 9:00 AM, John Siracusa wrote: Since those sections are clearly labeled and there are links to all the major sections (in the HTML version of the POD, that is), I don't think it's too onerous for those people that want to skip them to do so. Since nobody else agreed with