Hi All,
I hate replying to my own email, but in discussion with other folks it
has become clear to me that something I assumed isn't as obvious to
others as it is to me. Go figure :-).
The design proposal has two major parts in my thought process:
1) Schema elements and attributes. Basically the user interface in XML
that we want to present; It's form and content.
2) Schema language.
# 1 as outlined Section 5.3 is the user interface that we will export.
This is the first critical piece I need to be reviewed. I need folks to
look at the elements and attributes proposed, and the XML instance
documents associated with these(Starting on page 24, listed after each
schema definition). Key things to look at are:
-Are the elements sufficient to describe what we need to correctly and
fully represent the the user possibilities in AI and DC?
-Are their elements and/or attributes missing that are necessary?
-Are the elements and attributes defined in a way that allows ease of
use from a user perspective? Are they too nested, not nested enough, not
constrained enough, etc...
-Are the required and optional tags correct? That is are there things
that are required that are not specified that way, and vice versa?
#2) The schema language is a secondary piece of the design. I believe
that if we have a good XML definition for our documents, one that
provides an easy to use and complete specification for users then we can
create a schema to match this. The schema language may help provide a
better definition in some cases, but there isn't a 1-1 relationship in
the user interface design and the schema language.
Please review this proposal with these thoughts in mind.
Thank you for your time.
sarah
****
On 06/ 1/10 05:49 PM, Sarah Jelinek wrote:
Hi All,
A redesign effort has been under way for both the AI/DC schemas, and
as a result the manifests themselves. The documents listed below are
the first draft of the redesign proposal.
The documents are located in the caiman-doc repository both the .odt
and .pdf version of the AI/DC Schema and Manifest Redesign document.
You can get the docs here:
ssh://[email protected]/hg/caiman/caiman-docs
by pulling a clone.
I have also posted both versions on the opensolaris.org caiman project
page:
http://hub.opensolaris.org/bin/download/Project+caiman/WebHome/aidcmanifest.odt
http://hub.opensolaris.org/bin/download/Project+caiman/WebHome/aidcmanifest.pdf
Please send your feedback to the alias by 6/22/10.
If you plan to provide a review, please email me privately so I can
keep track of those who want to participate in the review. If you need
more time please let me know when you think you can complete the review.
As always, thank you for your time and attention.
Regards,
sarah
_______________________________________________
caiman-discuss mailing list
[email protected]
http://mail.opensolaris.org/mailman/listinfo/caiman-discuss
_______________________________________________
caiman-discuss mailing list
[email protected]
http://mail.opensolaris.org/mailman/listinfo/caiman-discuss
