[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