I am not extremely familiar with these kinds of standard
documents, but it seems to me the introductory part we have is too long.
Readers of this document are expected to know what a portal, a portlet, and a
web service are, and how they may work together.
The intended audience for the spec are the people who are
going to be implementing the standard - writing producers or consumers
(containers). What they are looking for is the technical detail, not the
screen captures. I think for them just the sheer size of the document is
intimidating, and having
to find where the actual technical information resides is a
nuisance.
I think the introduction to portals, web
services, etc. should go in a separate document. (white paper?)
I am referring to sections 1.1-1.4 mostly, since I wasn't
able to get much farther yet...
Yossi.
-----Original Message-----
From: Rich
Thompson [mailto:richt2@us.ibm.com]
Sent: Tuesday, September 03, 2002 3:56 PM
To:
wsia
Subject: RE: [wsia] [wsrp-interfaces] Draft spec
v0.5
I agree, but noticed it had grown to this level just as I was
sending it to
the mailing lists. I would suggest the
WSDL, use cases and UDDI (ie. use of
standardized
registries) discussion be moved into separate files. The WSDL
because this would then become a reference to the actual files that
should
be referenced by Producers. The others because
while they do help
understanding, they are not
normative relative to the spec.
Any thoughts/comments?
Gil
Tayar
<Gil.Tayar@webcol
To: Rich
Thompson/Watson/IBM@IBMUS
lage.com>
cc:
Subject: RE: [wsia] [wsrp-interfaces] Draft spec
v0.5
09/01/2002
07:13
AM
Rich,
You _must_ split this document into three or more. Some of the
edits I
tried
to do resulted
in corrupt files. This is a sure sign in Word that a
document
is getting too big.
Gil
-----Original Message-----
From: Rich
Thompson [mailto:richt2@us.ibm.com]
Sent: Fri, August 30, 2002 20:19
To:
wsia@lists.oasis-open.org; wsrp-interfaces@lists.oasis-open.org
Subject: [wsia] [wsrp-interfaces] Draft spec v0.5
The doc file has now grown to 11MB ....
(See attached file: Draft Spec v0.5.ZIP)
----------------------------------------------------------------
To subscribe or unsubscribe from this elist use the
subscription
manager: <http://lists.oasis-open.org/ob/adm.pl>
----------------------------------------------------------------
To subscribe or unsubscribe from this elist use the
subscription
manager: <http://lists.oasis-open.org/ob/adm.pl>