[oslc-core] OSLC Primer straw-man outline

[Arthur Ryman]

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 <snoopdave at gmail.com>
To:
oslc-core <oslc-core at open-services.net>
Date:
12/03/2010 10:17 AM
Subject:
Re: [oslc-core] OSLC Primer straw-man outline
Sent by:
oslc-core-bounces at open-services.net



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 <snoopdave at gmail.com> 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
Oslc-Core at open-services.net
http://open-services.net/mailman/listinfo/oslc-core_open-services.net