Thanks Gary! I'll use the suggestions as the first input of our public comment phase. Right now I'm uploading the docs into the editor tracker of OGF. Cheers, -Thijs Gary Mazz wrote:
Hi,
I got to start on some editorial changes to the OCCI XHTLM document. This is my quick stab at the first few paragraphs. These recommendations can be evaluated when the document is in the OGF comment pipeline.
-gary
*Abstract: Paragraph 1:*
This document describes elements of the Open Cloud Computing Interface (OCCI) represented as an XHTML document. This document is part of the Open Cloud Computing Interface (OCCI) specification. The OCCI specification describes actions, semantics, a data representation and protocol to uniformly administer IaaS clouds over HTTP. The OCCI specification is divided into the following sections:
*Abstract: Paragraph 2: *• The OCCI Core Model • The OCCI Infrastructure Model
*Abstract: Paragraph 3:* The OCCI specification is configured as a document set. Each section is described in a separate specification document. All sections and the information within are mandatory for implementors (unless otherwise specified).
* 1.1. Introduction: Paragraph 1: *This specification provides the normative rules and recommendations that describe the structure of the Open Cloud Computing Interface's actions, semantics, data representations and other corresponding elements as XHTML documents. This specification defines all XHTML elements relevant to representing the OCCI elements in XHTML; describes how OCCI elements are represented as XHTML document elements and defines OCCI elements are functionally equivalent with each XHTML element. The XHTML specification defines document elements, including organizations, data, meta data, and representation formats, not defined and not applicable to the OCCI specifications. All OCCI conformant implementations will adhere to the definitions prescribed in this specification.
*1.2. XHTML5: Paragraph 1: (new) *XHTML5 is an XML-based “concrete syntax” of the “World Wide Web's “abstracted markup language, HTML5. The XHTML5 specification mandates syntax to be well formed significantly reducing potential for document misinterpretation. For the purposes of this specification, we limit the scope of the XHTML specifications to the "XHTML Basic document" referenced as TR/2008/REC-xhtml-basic-20080729. The XHTML Basic document type includes the minimal set of modules required to be an XHTML host language document type, and in addition it includes images, forms, basic tables, and object support. It is designed for Web clients that do not support the full set of XHTML features; for example, Web clients such as mobile phones, PDAs, pagers, and settop boxes. The document type definition is implemented using XHTML modules as defined in the W3C doument "XHTML Modularization"
* *
------------------------------------------------------------------------
_______________________________________________ occi-wg mailing list occi-wg@ogf.org http://www.ogf.org/mailman/listinfo/occi-wg
-- Thijs Metsch Tel: +49 (0)941 3075-122 (x60122) http://blogs.sun.com/intheclouds http://www.twitter.com/befreax Software Engineer Cloud, Grid and Virtualization Sun Microsystems GmbH Dr.-Leo-Ritter-Str. 7 mailto:thijs.metsch@sun.com D-93049 Regensburg http://www.sun.com