[occi-wg] Current work on documentation

[Kristoffer Sheather]

Thijs, 

Thanks for the document, looks to be coming along well. 

I'm wondering whether there has been any thought or discussion about using WADL as a machine protocol description format for the OCCI REST interface?

Cheers,
Kris

----------------------------------------
From: Thijs Metsch <Thijs.Metsch at Sun.COM>
Sent: 16 July 2009 01:42
To: "occi-wg at ogf.org" <occi-wg at ogf.org>
Subject: Re: [occi-wg] Current work on documentation 

Hi guys,

This is the current version of the document which I created from the
source on gridforge.

It currently contains all the information we are about the write up.
Later on it will be slitted in the two documents described below.

All the best,

-Thijs

On Wed, 2009-07-15 at 16:49 +0200, Thijs Metsch wrote:
> Hi guys,
> 
> I just wanted to give a short update on process of documentation. These
> are the things we are currently working on. We have two documents which
> will be released by OGF27.
> 
> Those document will be called:
> 
> - Open Cloud Computing Interface Specification
> 
> - Open Cloud Computing Interface - Usecases and requirements for a Cloud
> interface
> 
> The first document is the writeup of the OCCI API while the second
> documents sums up the requirements and use cases we have. The first
> document will be structured like this - so this is how we present OCCI:
> 
> * Introduction
> * OCCI Walkthrough
>   * Overview
>   * Getting started
>   * Operations
>   * Collections
> * OCCI core specification
>   * Basics
>   * Extensions
>   * Examples
> * Infrastructure
>   * Nouns
>      * Compute
>      * Storage
>      * Network
> * OCCI Registries
> 
> It is important that we get this right - so to say that we can give this
> document to a implementor and he can implement it easily while just
> reading this document!
> 
> Andy, Andre, Sam and me are working on this documents right now - but
> feel free to join or comment to us and the mailing-list.
> 
> If you want to look at the current working copy of the document the
> sources can be found in the gridforge:
> 
> http://forge.ogf.org/sf/scm/do/viewRepositorySource/projects.occi-wg/scm.Open_Cloud_Computing_Interface
> 
> We are writing this up using docbook. The main article is called
> occi-book.xml which includes all the further articles. With the help of
> the Makefile you can create html and pdf versions of all the content.
> 
> Sam and Andy will also send an update on the changes made to the version
> of in Wiki!
> 
> All the best,
> 
> -Thijs
> 
-- 
Thijs Metsch                        Tel: +49 (0)941 3075-122 (x60122)
http://blogs.sun.com/intheclouds
Software Engineer Grid Computing
Sun Microsystems GmbH
Dr.-Leo-Ritter-Str. 7               mailto:thijs.metsch at sun.com
D-93049 Regensburg                  http://www.sun.com

_______________________________________________
occi-wg mailing list
occi-wg at ogf.org
http://www.ogf.org/mailman/listinfo/occi-wg


-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.ogf.org/pipermail/occi-wg/attachments/20090716/70787375/attachment.html