[oslc-core] awkward statement in Core on pre-filling creation dialogs

Steve K Speicher sspeiche at us.ibm.com
Wed Sep 7 11:37:01 EDT 2011


> From: John Arwe/Poughkeepsie/IBM at IBMUS
> To: oslc-core at open-services.net, 
> Date: 09/01/2011 04:32 PM
> Subject: [oslc-core] awkward statement in Core on pre-filling creation 
dialogs
> Sent by: oslc-core-bounces at open-services.net
> 
> http://open-services.net/bin/view/Main/OslcCoreSpecification?
> sortcol=table;table=up;up=#Dialog_Resizing then page up 
> 
> Prefilling Creation Dialogs 
> Service providers MAY support receiving a POST request whose content 
body is
> a change request resource definition to the Creation Dialog URI to 
retrieve 
> a URI that represents the embedded page to be used. Service providers 
MUST 
> respond with a response status of 201 (Created) with the response header 
Location
> whose value is the URI to request the newly created form. Service 
providers MAY NOT
> maintain the created form in a persistent storage. Clients SHOULD expect 

> that after some elapsed time, a GET on these transient response URIs MAY 

> result with response status codes of 404 (Not found) or a 3xx 
(Redirect). 
> "MAY NOT" could be read to mean "MUST NOT" or "MAY" ... if the intent 
was to
> allow implementations to do whatever they want, dropping NOT reads no 
worse 
> and conveys the intent clearly.  Assuming that same intent, if the 
purpose 
> of using MAY NOT in the original was to gently nudge readers towards 
> thinking "bad idea, why would I do that", then SHOULD NOT or NOT 
RECOMMENDED
> might be more appropriate. 

I think this may have been a case of RFC-2119 upcasing.  I think the 
intent of that original statement is informative in saying that servers 
may (or may not) persist something on the server.  Just because you 
receive a POST request, it is possible to respond with a new URL in the 
Location header with a 201 response.  I might recommend that the upcasing 
and choice of words be reconsidered.  Such as "Service providers MAY 
maintain the created form in a persistent storage." but does that really 
make it any better.  Other suggestions welcome

Thanks,
Steve Speicher | IBM Rational Software | (919) 254-0645





More information about the Oslc-Core mailing list