[Osr-101] Neutron specs

[Thomas Comiotto]

Hi all,

I have worked a bit on the specs during the last couple of days. Here's 
a short preliminary list of what I would like to have changed.

  * Let's add identifiers to resources. Currently we have an edit 
directive containing a bunch of methods operating on a remote resource 
identified by nill. However, resource identifiers are crucial for view 
templating for instance. They are also crucial for resource sets (see 
below). I propose to kick out the open command and replace it by a 
<resource> element attributing for url and name of the resource:

<introspection>
   <edit>
     <resource url="hello.xml" name="Hello document">
       <save url="hello.xml?neutron.cmd=save" httpMethod="PUT"/>
     </resource>
   </edit>
</introspection>

* Looking at the above snippet I think we should remove the edit 
directive alltogether! The purpose of the contained methods is evident 
so what's it good for?

<introspection>
   <resource url="hello.xml" name="Hello document">
     <save url="hello.xml?neutron.cmd=save" httpMethod="PUT"/>
   </resource>
   <resource url="hallo.xml" name="Dokument Hallo">
     <save url="hallo.xml?neutron.cmd=save" httpMethod="PUT"/>
   </resource>
   <navigation>
     <sitetree url="sitetree.xml"/>
   </navigation>
</introspection>

* Let's replace the "method" attribute of all methods that use it 
(save, checkin) by attributes that account for the url scheme used 
(file, http, ftp, whatever). So in case of http, method="PUT" should 
read httpMethod="PUT" as in the above snippet.
* I have added view templating to the specs. Please review and comment.
* I have added resource sets to the specs. Please review and comment.


Otherwise I hope you like the changes I forgot to mention here:)

--
Bests
Thomas