Dave, Yes, that's my point about the Primer. As for the other material, that's really more of an editorial decision. You can start with a single Overview doc, but if it gets unwieldy, then split it.
I've give the Primer highest priority. I think the Primer would have the most impact on the implementer community. Being a primate, I believe in the "Monkey See, Monkey Do" approach to learning software technology. :-) Regards, ___________________________________________________________________________ Arthur Ryman, PhD, DE Chief Architect, Project and Portfolio Management IBM Software, Rational Markham, ON, Canada | Office: 905-413-3077, Cell: 416-939-5063 From: Dave <[email protected]> To: oslc-core <[email protected]> Date: 12/03/2010 10:17 AM Subject: Re: [oslc-core] OSLC Primer straw-man outline Sent by: [email protected] I didn't respond to Steve's suggestion of multiple documents: New to OSLC Architecture Implementers OSLC Domains OSLC Community I think Arthur's point was that the primer should be to-the-point with concrete examples, so of your suggestions, I think only the Implementors doc would be called the OSLC Primer. A architecture document could be useful, but I think we need more overview and introductory material first. And, so I'd like to combine the New to OSLC, Architecture, Domains and Community topics into one overview. That's why I like the two document approach: OSLC Primer and OSLC (Technical?) Overview. - Dave On Fri, Dec 3, 2010 at 9:32 AM, Dave <[email protected]> wrote: > Arthur, Thanks for being very specific. > > Seems that we need two documents: > - OSLC Overview > - OSLC Primer > > As you can see from my proposed outline, I think both are high > priority concerns and deserve to be completed at one time as one > document or a pair of documents. > > What do others think about priority? Should we focus exclusively on a > Primer first, or push both ideas forward now? > > - Dave _______________________________________________ Oslc-Core mailing list [email protected] http://open-services.net/mailman/listinfo/oslc-core_open-services.net
