OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

humanmarkup message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Subject: [humanmarkup] First Working Draft of HM.Requirements


Title: First Working Draft of HM.Requirements
Hello Everyone,
Please excuse me if I combine the messages to our TC and to OASIS. I think it is necessary for both audiences to be aware of concerns expressed to each.  I am attaching our normal text-only format and a Word .doc format as well since .txt includes no line breaks.

------------------------
I am going to cover OASIS concerns first so that they do not have to search for the questions for which we need answers.

Karl, Please distribute this to whomever you think would be able to help, or simply respond yourself, but we do ask that you please be prompt.

OASIS ITEM 1: Under PROCESS REQUIREMENTS section, we chose to specifically state compliance to and so to emphasize our commitment to these policies. Do we need to cite a specific document or set of documents for these policies? Is it assumed that any and all TCs follows these policies? Does this TC need or is it allowed to make explicit statements about policy with regard to 'openness,'  'public v. publicly available,' considerations? This relates to soliciting feedback from developers and users in a public forum.

OASIS Iterm 2: In regard to IPR, can a TC set further restrictions or constraints upon its processes or the use(s)/extension(s) of its specifications? In other words, can OASIS specifications be extended in proprietary applications which exclude further uses of the OASIS specification which also include the proprietary application or results from use of that application?

For example, can someone take a HumanMarkup Specification, add proprietary methods or operations that result in a perfectly valid xml extension--by xml rules--thereby creating results for which they can charge or prohibit the use of such extended alterations to, for example, any individual's HumanML-based preferences profile?

Are there any such examples from other TCs?

OASIS Item 3: In considering the implications of XML policy with regard to Unicode, we pondered a requirement for compliance with it, but decided against it since it is not within our scope, but since we have a great interest in making HumanMarkup independent of cultural and language biases, we would like to know if OASIS has a policy about this to which we can refer to which we can stipulate.

OASIS Item 4: We would like to make HumanMarkup independent of any specific xml schema or DTD, even while we seek to be interoperable with the widest possible application base. One way to do this, and to prevent any vocabulary conflicts with related schemata or specifications would be for all elements and attributes we specify to contain a prefix specfic to the term, and also covered by an official glossary contained in our namespace(s). Thus all HumanMarkup Elements would be in the form huml.ElementName. Since this sort of mechanism could be applicable to all OASIS specifications, we need to know if this is allowable or advisable.

End of OASIS-specific concerns and questions.
------------------------

This is the first Working Draft of HM.Requirements based on the process the OASIS HumanMarkup Technical Committee adopted for this purpose. This marks the transition from the requirements-gathering phase of our initial work to the specifications-writing phase.

This draft was based on the detailed discussions of the latest strawman draft including submissions to date held during the monthly meeting of the TC held March 20, 2002 by teleconference. I needs to be proofread for typographical and grammatical correctness as well as for technical considerations.

**It is also noted that we do not have, and have not discussed any need for an introduction. Therefore, some passages are included which cite guiding principles from our TC charter, such as making reference to and specifying focus upon communication and the imperative to include the means to enable cultural modules in our base schema.**

A decision to include a short introduction would not, in this interim author's opinion necessitate removing those short sentences. This author, also, does not think an introduction is necessary, but notes that many other such documents do include one, though most have some informational purpose beyond simply stating objectives.

Two items were added or amended by the interim author, the TC Secretary Rex Brooks, and are his responsibility. The reasons are given here after the citation. There are numerous other small changes, and a great many deletions of material disclaiming the interim status of previous drafts that no longer apply. I mention that because we did not specifically cover that in our meeting.

Item 1: Under the PROCESS REQUIREMENTS section, the name was changed, adding the word PROCESS, to distinguish these particular requirements from the stipulations of the entire document, and the following paragraph was added in the belief that this was the guiding principle by which we included the terms DEVELOPER(S) and USER(S) to the TERMINOLOGY section, and it is not specifically covered by the OASIS guidelines and policies.

"When and where possible, feedback from DEVELOPERS and USERS SHOULD be sought to improve the useability of all HumanML specifications.

Item 2: Under the MODULARITY section, the Element Name: HumanIndentity was reverted to: HumanIdentifier because that was the term used in the Phase 0 Toolkit Schema, and there seemed to be no need to change that. An addition was added to note that the TC may add more standards for which compliance will be required in order to ensure that all modules created from this Element or with this Element will be widely interoperable. It now reads:

The Primary Base HumanML Schema MUST include a HumanIdentifier Element that is compatible with and interoperable with the U.S. Federal Government standards, standards accepted by a majority of Public Safety Institutions, Federal, State and Local Law Enforcement practices,HR-XML specifications, American Medical Association standards and any standards so designated by the OASIS HumanMarkup Technical Committee. Thus, all HumanML modules should be compatible with and interoperable with these standards and recommended practices.

**Note: some of the possible conflicts of vocabularies between or amongst these overlapping specifications and standards would be eliminated by the universal practice of putting all HumanMarkup Elements and Attributes in the forms: huml.ElementName and huml.AttributeName, or in this case, huml.HumanIdentifier.**

Lastly, the primary way in which we can ensure compatibility, compliance and interoperability is to specify the minimal number of elements and let usage and what we learn from it, determine the further development of HumanMarkup.

No doubt we will encounter numerous unanticipated concerns as we proceed.

Thanks Everyone, and please be prompt in responding. Our target is still March 31, 2002 to wrap this up.

Regards,
Rex Brooks
OASIS HumanMarkup Vice Chair, Secretary and Webmaster


-- 

HM.RqtsWrkgDrft1.doc

HM.REQUIREMENTS
last updated: 31March 2002
(this document describes the different requirements for the HumanMarkup specifications)
---------------------


----------------
ABSTRACT:
----------------
This document specifies the formal Requirements for the Base Primary Human Markup Language Schema, the process for revising the Base Primary Schema and creating the currently planned and as yet unplanned Secondary Human Markup Schemata.

----------------
DOCUMENT STATUS:
----------------

The design of HumanML covers a large scope of possible applications.  This Requirements Document  is designed in the expectation that this document, the Primary Base Human Markup Language Schema and Secondary Human Markup Language Schemata will be modified as needed.

This document is normative as of the date it is adopted by the OASIS HumanMarkup Technical Committee.  

----------------
TERMINOLOGY:
----------------
For the purposes of clarity, we offer these definitions for terms we use in general and which may appear in this document but are not specific to this document:

Human Markup Language (compound term with separated words with Upper and Lower case characters as shown) = the XML-based computer networking language specification itself and all of its associated modules and sub-specifications.

HumanML(compound term with Upper and Lower case characters as shown) = the Human Markup Language Specification.

HumanMarkup (compound term with Upper and Lower Case characters as shown) = the collective effort to build the Human Markup Language, also used for similar purposes in the name of the OASIS HumanMarkup Technical Committee.

The rules below mark the end of the definitions of general use terms HumanMarkup terms.
----------------
----------------
The following terminology is used specifically for and throughout this document, without any claims of applicability outside it. 

When capitalized the key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" AND "OPTIONAL" is this document are to interpretated as described in RFC 2119. ref.: http://www.ietf.org/rfc/rfc2119.txt

HUMAN 
When capitalized, as above, this term is defined as what the HumanMarkup Initiative aims to encapsulate into HumanML. Used thus, this term applies to HUMAN individuals, HUMAN thought, HUMAN activities.

"human"
When enclosed in double quote marks without capitalization, as above, this term is defined as an individual entity that may represent a living human being in a digital environment with the rights and privileges granted to a "human" or a software AGENT acting as a "human." 

DEVELOPER(S)
When capitalizaed, as above, this term is defined as (a) software developer(s), software engineer(s), or software programmer)s) who build an application that utilizes HumanML.

USER(S) 
When capitalized, as above, this term is defined as (a) consumer(s) of HumanML applications.

Note: Unless specifically stated otherwise, the use of the word 'schema' in all of its variations refers to XML Schema because this documents is aimed at that application. XML will be used a few times at the startThere will be specific mention of RDF Schema, and its references will be explicit in each use.

----------------
CLASSIFICATION:
----------------
Primary and Secondary Schemata

This document distinguishes the Basic HumanMarkup Schema as the Primary Base Human Markup Language XML Schema and subsequent modules as Secondary Human Markup Language XML Schemata. Primary Schema and Secondary Schemata represent categories for distinguishing between Schemata of the fundamental or extended domain, respectively. All Secondary Schemata are capable of engendering and containing further modules which can be classified as derivative or submodules as appropriate, but which may always be seen as existing in the Secondary grouping on an equal footing. 

The Primary Base Human Markup Language XML Schema MUST contain the Elements and Attributes to describe the basic or fundamental set of characteristics of HUMAN entities and HUMAN activities as they occur in digital information systems. In keeping with the charter of the OASIS HumanMarkup Technical Committee, which states that the aim of HumanML is to "enhance the fidelity of human communication," this schema SHOULD specifically address the HUMAN activity of communication. 

The Primary Base Human Markup Language XML Schema MUST contain the Elements and Attributes from which the Secondary Human Markup Language XML Schemata can be extended.

If the Primary Base Human Markup Language XML Schema does not contain the Elements and Attributes from which a specific Secondary Human Markup Language XML Schema can be written, those elements and attributes necessary to produce the specific Secondary HumanML XML Schema MUST be added to the Primary Base HumanML XML Schema.

Therefore, a mechanism, method or means to add Elements and Attributes to the Primary Base HumanML XML Schema MUST be constructed and approved. 

When this mechanism, method or means is approved, it should added here:

(Mechansim, Method or Means of Adding Elements and Attributes to the Primary Base HumanML XML Schema)

The specific Secondary Human Markup Language Schemata that are currently planned or anticipated are:

* Cultural Schemata;

* Virtual Reality and Artificial Intelligence Schemata;

* Human Physical Characteristics Description Markup Language Schema;

* Conflict Resolution and Diplomatic Communications Schemata;

* Various Schemata related to Human Profiling in terms of preferences and behavior tracking

* Various Schemata related to Human Psychology.

It is noted that this is a partial list only.

----------------
EXISTING STANDARDS:
----------------
The Primary Base Human Markup Language Schema will be based on:
XML 1.0, http://www.w3c.org/TR/2000/REC-xml-20001006 
XML Namespaces, http://www.w3c.org/TR/1999/REC-xml-names-19990114/ 
and XML Schema http://www.w3.org/TR/xmlschema-1/ http://www.w3.org/TR/xmlschema-2/

The OASIS HumanMarkup Technical Committee SHALL also provide for an RDF Schema to represent the same elements and attributes of the Primary Base HumanML and Secondary HumanML XML Schemata in RDF terms.

----------------
PROCESS REQUIREMENTS:
----------------
The Primary Base HumanML and Secondary HumanML Schemata SHALL be produced in accordance with OASIS principles and policies with regard to open, public standards processes and IPR.

When and where possible, feedback from DEVELOPERS and USERS SHOULD be sought to improve the useability of all HumanML specifications. 

----------------
COMPATIBILITY:
----------------
HumanML MUST conform to XML syntax and rules.

Terseness SHOULD be sought. This is to be considered a guiding principle. By adopting this principle as a requirement at this level of commitment, The OASIS HumanMarkup Technical Committee aims to ensure greater compatibility through a lack of unnecessary complexity.


----------------
EXTENSIBILITY:
----------------
The Primary Base HumanML and Secondary HumanML Schemata MUST be extensible. 


----------------
MODULARITY
----------------
HumanML SHALL be organized into a Primary Base HumanML Schema and Secondary HumanML Schemata. All Schemata SHALL be considered modules. All HumanML modules MUST be interoperable with each other, as well as such standards as SHALL be so designated. 

The Primary Base HumanML Schema MUST include a HumanIdentifier Element that is compatible with and interoperable with the U.S. Federal Government standards, standards accepted by a majority of Public Safety Institutions, Federal, State and Local Law Enforcement practices,HR-XML specifications, American Medical Association standards and any standards so designated by the OASIS HumanMarkup Technical Committee. Thus, all HumanML modules should be compatible with and interoperable with these standards and recommended practices.

----------------
TRUST/DIGITAL SIGNATURES:
----------------
All HumanML Schemata, including RDF Schemata, SHALL recognize XML Digital Signatures and SHALL be constructed to comply with such Trust and Security specifications as shall be deemed necessary by the OASIS HumanMarkup Technical Committee.


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Powered by eList eXpress LLC