[occi-wg] Comments on OCCI XHTML Document

[Gary Mazz]

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"



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