[Osr-101] Neutron specs

[Michael Wechner]

Thomas Comiotto wrote:

> Hi all,
>
> I have worked a bit on the specs during the last couple of days.


cool :-)

> 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


How do you want to differentiate between open and checkout (acquire lock 
and open)?

> 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?


it makes clear what can be done and allows to differentiate between 
operations. I am not sure if I understand what you mean, but
maybe you actually mean something like this:

<introspection>
  <resource name="Hello World">
    <edit mime-type="application/xhtml+xml">
      <checkout url="helloworld.xhtml?foobar=checkout" method="GET"/>
      <checkin url="helloworld.xhtml?foobar=checkin" method="POST"/>
    </edit>

    <workflow>
     ...
    </workflow>
  </resource>

....
</introspection>

WDYT?

>
> <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.



you mean that Neutron could also be placed on top of other protocols 
than just HTTP?

> * I have added view templating to the specs. Please review and comment.


ok, will review

> * I have added resource sets to the specs. Please review and comment.


will review

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


will check :-). I think we should introduce "Paces" as Atom does in 
order to discuss changes, otherwise I am
afraid that we get into a commit war at some point ;-)

All the best

Michi

>
> -- 
> Bests
> Thomas
>
>
>
>
>
>
>
> _______________________________________________
> Osr-101 mailing list
> Osr-101 at wyona.org
> http://wyona.com/cgi-bin/mailman/listinfo/osr-101
>


-- 
Michael Wechner
Wyona      -   Open Source Content Management   -    Apache Lenya
http://www.wyona.com                      http://lenya.apache.org
michael.wechner at wyona.com                        michi at apache.org
+41 44 272 91 61