[oslc-Metrics] [OSLC-Metrics] Request for Review: REST API Architecture Topic

Andrew J Berner ajberner at us.ibm.com
Tue Feb 9 13:40:26 EST 2010


Sorry for the delay.  There are lots of subtle points related to the
Architecture page.  I was in a quandary:  since that page is "high level",
the subtle points may not need to be addressed right on this page...too
many trees obscure the forest.  But unless the subtleties are on the table,
we'll draw wrong conclusions later based on an "approved" page, so they
need to come out now, even if discussion on them is deferred a bit.   I
tried to write this up in detail but in a way I hope is understandable.  We
must reach the detail at some point, after all!

Attaching the writeup as a document rather than inline, so you can use
markup/comments more easily.  But it's "draft level"...not carefully edited
etc, so that I can get it to y'all, and put the issues on the table for
further discussion.  Some of this is based on discussions we had and pages
already in the Wiki (I didn't take the time, though, to find all the Wiki
refereences), and some may be new.
(See attached file: review of architecture page.doc)


Andy Berner
Lead Architect, ISV Technical Enablement and Strategy
IBM Rational Business Development
972 561-6599
ajberner at us.ibm.com

Ready for IBM Rational software partner program -
http://www.ibm.com/isv/rational/readyfor.html


|------------>
| From:      |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |Arthur Ryman/Toronto/IBM at IBMCA                                                                                                                    |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| To:        |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |Andrew J Berner/Dallas/IBM at IBMUS                                                                                                                  |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Cc:        |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |oslc-metrics at open-services.net                                                                                                                    |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Date:      |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |02/08/2010 02:57 PM                                                                                                                               |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Subject:   |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |Re: [OSLC-Metrics] Request for Review: REST API Architecture Topic                                                                                |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|




Andy,

Could you please identify the points that require further discussion? Thx.

Arthur Ryman, IBM DE
Chief Architect, Rational Project and Portfolio Management
Office: 905-413-3077, Cell: 416-939-5063
Assistant: Nancy Barnes, 905-413-4182



|------------>
| From:      |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |Andrew J Berner/Dallas/IBM at IBMUS                                                                                                                  |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| To:        |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |oslc-metrics at open-services.net, Arthur Ryman <ryman at ca.ibm.com>                                                                                   |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Date:      |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |02/06/2010 08:45 AM                                                                                                                               |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Subject:   |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |Re: [OSLC-Metrics] Request for Review: REST API Architecture Topic                                                                                |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|




This page is problematic I think, but in ways that are not directly
relevant to the review of the EMS that we need to do.  So we can debate
this in parallel.  Let me be clear about what I mean:  I think that while
this page is very well written, it will need a significant revision in its
content (much of which is new to our discussion, though maybe it's been
written down here for a while--I haven't looked at the page in a while).

But my issues with the content don't affect the definition of the
resources, nor the URL's and responses to manipulate those resources, that
we have to define for the OSLC spec.  So while debating about this page
(which I don't have time right now to begin), we can keep on going with the
resource specs.

So to summarize, I don't yet approve this page, but that doesn't have to
hold up the review of the spec. of the resources and URL's which is our
main work.

Andy Berner
Lead Architect, ISV Technical Enablement and Strategy
IBM Rational Business Development
972 561-6599
ajberner at us.ibm.com

Ready for IBM Rational software partner program -
http://www.ibm.com/isv/rational/readyfor.html



|------------>
| From:      |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |Arthur Ryman <ryman at ca.ibm.com>                                                                                                                   |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| To:        |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |oslc-metrics at open-services.net                                                                                                                    |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Date:      |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |02/04/2010 03:32 PM                                                                                                                               |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Subject:   |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |[OSLC-Metrics] Request for Review: REST API Architecture Topic                                                                                    |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Sent by:   |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |oslc-metrics-bounces at open-services.net                                                                                                            |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|






The following page (not the pages linked from it) is ready for your review.
Please post your positive and negative comments in reply to this note. Thx.


EMS 1.0 REST API Architecture

http://open-services.net/bin/view/Main/MetricsEMS10RestApiArchitecture

Arthur Ryman, IBM DE
Chief Architect, Rational Project and Portfolio Management
Office: 905-413-3077, Cell: 416-939-5063
Assistant: Nancy Barnes, 905-413-4182
_______________________________________________
OSLC-Metrics mailing list
OSLC-Metrics at open-services.net
http://open-services.net/mailman/listinfo/oslc-metrics_open-services.net



-------------- next part --------------
A non-text attachment was scrubbed...
Name: review of architecture page.doc
Type: application/msword
Size: 28672 bytes
Desc: not available
URL: <http://open-services.net/pipermail/oslc-metrics_open-services.net/attachments/20100209/17e62532/attachment.doc>


More information about the Oslc-Metrics mailing list