OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

wsrp-wsia message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Subject: [wsrp-wsia] [change request #196] Making conformance statementsstand-alone


Document: Spec
Requested by: Rich Thompson
Reasoning: A number of conformance statements do not stand on their own 
very well. These proposals change the wordings to enable them to be 
extracted from the spec without losing all meaning.

ID: A
Section: 5.1.11
Page/Line: 20/17
Old text: If the Consumer uses this portlet, the Consumer MUST format its 
URLs in a manner that keeps user-agents from throwing away information 
(see section 10.2.4 for a description of the difficulties in using forms 
with method=get).
New text: If the Consumer uses a Portlet which specifies 
usesMethodGet="true", the Consumer MUST format its URLs in a manner that 
keeps user-agents from throwing away information (see section 10.2.4 for a 
description of the difficulties in using forms with method=get).

ID: B
Section: 5.2
Page/Line: 24/45
Old text: The minimum information a Producer MUST return is that which 
declares what is required for a Consumer to register (i.e. the 
requiresRegistration flag and the registrationPropertyDescription field) 
with the Producer
New text: The minimum information a Producer MUST return from 
getServiceDescription() is that which declares what is required for a 
Consumer to register (i.e. the requiresRegistration flag and the 
registrationPropertyDescription field) with the Producer

ID: C
Section: 5.2
Page/Line: 25/6
Old text: Producers MUST return a complete enough description to 
registered Consumers for them to properly interact with both the Producer 
and Portlets it exposes.
New text: Producers MUST return a complete enough ServiceDescription to 
registered Consumers for them to properly interact with both the Producer 
and Portlets it exposes.

ID: D
Section: 6.1.2
Page/Line: 26/36
Old text: Consumer SHOULD keep it as short as possible.
New text: Consumers SHOULD keep their portletInstanceKey values as short 
as possible.

ID: E
Section: 6.1.10
Page/Line: 32/18
Old text: This field MUST be specified whenever markup is returned.
New text: The locale MUST be specified whenever markup is returned.

ID: F
Section: 6.1.10
Page/Line: 32/21
Old text: The Consumer MUST parse the markup for URL rewriting if this 
flag is set to “true”.
New text: The Consumer MUST parse the markup for URL rewriting if the 
value of requiresURLRewriting is “true”.

ID: G
Section: 6.1.10
Page/Line: 32/24
Old text: If this field is not supplied, the Consumer MUST treat the 
returned markup as not cachable.
New text: If the cacheControl field is not supplied, the Consumer MUST 
treat the returned markup as not cachable.

ID: H
Section: 6.1.13
Page/Line: 34/1
Old text: The Consumer MAY choose to respect this request, but since the 
Portlet cannot depend on that choice it MUST NOT encode this new window 
state into any of its stateful settings. Rather, the Portlet MUST compute 
any such impact on stateful settings after the Consumer has actually 
changed the window state.
New text: The Consumer MAY choose to respect this request to change window 
state, but since the Portlet cannot depend on that choice, it MUST NOT 
encode this new window state into any of its stateful settings. Rather, 
the Portlet MUST compute any such impact on stateful settings after the 
Consumer has actually changed the window state.

ID: I
Section: 6.1.13
Page/Line: 34/6
Old text: The Consumer MAY choose to respect this request, but since the 
Portlet cannot depend on that choice it MUST NOT encode this new mode into 
any of its stateful settings. Rather, the Portlet MUST compute any such 
impact on stateful settings after the Consumer has actually changed the 
mode.
New text: The Consumer MAY choose to respect this request to change the 
mode, but since the Portlet cannot depend on that choice, it MUST NOT 
encode this new mode into any of its stateful settings. Rather, the 
Portlet MUST compute any such impact on stateful settings after the 
Consumer has actually changed the mode.

ID: J
Section: 6.8.1
Page/Line: 45/10
Old text: All Portlets MUST support the view mode.
New text: Conformant Portlets MUST support the view mode.

ID: K
Section: 6.9.1
Page/Line: 46/3
Old text: It MAY also indicate that the target device has limited display 
capabilities.
New text: The "normal" window state MAY also indicate that the target 
device has limited display capabilities.

ID: L
Section: 6.9.1
Page/Line: 46/6
Old text: All Portlets MUST support the normal window state.
New text: Conformant Portlets MUST support the normal window state.

ID: M
Section: 7.1.1
Page/Line: 48/4
Old text: This string MUST start with ... 
New text: The value for consumerAgent MUST start with ...

ID: N
Section: 10.2.1.1.1
Page/Line: 57/31
Old text: Prior to invoking this operation the Consumer MUST ... 
New text: Prior to invoking performInteraction() the Consumer MUST ...

ID: O
Section: 10.2.1.1.1
Page/Line: 57/33
Old text: The Consumer MUST process all mode and window state change 
requests and either honor or reject them prior to invoking the operation.
New text: The Consumer MUST process all mode and window state change 
requests and either honor or reject them prior to invoking 
performInteraction().

ID: P
Section: 10.2.1.1.2
Page/Line: 58/3
Old text: Prior to invoking this operation the Consumer MUST ... 
New text: Prior to invoking performBlockingInteraction() the Consumer MUST 
...

ID: Q
Section: 10.2.1.1.2
Page/Line: 58/5
Old text: The Consumer MUST process all mode and window state change 
requests and either honor or reject them prior to invoking the operation.
New text: The Consumer MUST process all mode and window state change 
requests and either honor or reject them prior to invoking 
performBlockingInteraction().

ID: R
Section: 10.2.1.1.4
Page/Line: 58/31
Old text: Also note that since this URL will appear as a parameter value, 
it MUST be strictly encoded ...
New text: Also note that since resource URLs appear as a parameter value, 
they MUST be strictly encoded ...

ID: S
Section: 10.2.1.4
Page/Line: 59/21
Old text: This value MUST be one of the modes detailed in section 6.8 or 
... 
New text: The value for wsrp-mode MUST be one of the modes detailed in 
section 6.8 or ...

ID: T
Section: 10.2.1.7
Page/Line: 60/2
Old text: A boolean indicating whether the resulting URL MUST ... 
New text: The value for wsrp-secureURL is a boolean indicating whether the 
resulting URL MUST ...


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Powered by eList eXpress LLC