Submission of Election Markup Language v5.0 for Public Review/CS Ballot/OS Ballot

["Mary McRae" <mary.mcrae@oasis-open.org>]

Hello John,

 

I've reviewed the specification and identified the following issues that must be addressed before the public review can be announced.

 

Submitted file(s):

EML Process & Data Requirements v5

EML Schema Descriptions

EML v5 Changes Log

EML schemas

EML v5.0 Data Dictionary

 

 

Metadata

- Specification Title and Version

Specification Titles are unclear; it appears that there are two different specifications. Suggest documents be renamed: (optional)

Election Markup Language (EML) Version 5.0

Schema Descriptions

and

Election Markup Language (EML) Version 5.0

Process and Data Requirements

 

- Stage and Revision

Committee Draft not properly identified; must be Committee Draft 01

 

- Date

OK

 

- URIs

URIs must identify each of the three required versions and point to locations in docs.oasis-open.org. See http://docs.oasis-open.org/specGuidelines/namingGuidelines/metadata.html#specURIs for rules and examples.

Suggested URIs:

This Version: http://docs.oasis-open.org/election/eml/5.0/cd01/EMLProcessDataReqs.pdf (etc.)

Previous Version: (working draft URI)

Latest Version: http://docs.oasis-open.org/election/eml/5.0/EMLProcessDataReqs.pdf (etc.) [note non-version-specific]

 

- TC Name

The name of the Technical Committee must appear in the text with a hyperlink to the appropriate location; i.e.

OASIS Election and Voter Services Technical Committee (correct in Schema Descriptions doc)

 

- Chair(s)

OK

 

- Editor(s)

OK

 

- Related Work

Should be a hyperlink to EML v4.0

 

- Namespaces

A URN namespace is declared in Section 2.5 of EML Schema Descriptions. This namespace must be noted on all cover pages.

 

- Abstract

OK

 

Boilerplate

- Status

   - IPR URI

OK

   - Comment URI

OK

   - Errata URI

missing

 

- Notices

   - Legacy / Current

OK

   - Trademark Terms

helper text (in square brackets) still inline and no trademark terms have been inserted.

   - Copyright line

OK

 

Hyperlinks

- Activated

OK

- Appropriate Link Targets

OK

 

Footers

no editable source provided; no footers appearing in PDF

- Document Identifier

- Copyright

- Date

- Page Numbers

 

Layout

- OASIS Logo

OK

 

- Page Layout

EML Process and Data Requirements cover page layout doesn't conform to XHTML styles (see http://docs.oasis-open.org/templates/OASISSpecificationTemplateV3.0.html); unclear if proper templates were used for authoring as editable source was not included. EML Schema Descriptions properly conforms to look and feel.

 

- Colors

OK

 

- Typestyle

OK

 

Formats

- XHTML

Documents are not valid XHTML; TC Administration to handle cleanup.

 

- PDF

It appears that the files were originally authored in MS Word, but the PDF appears to have been generated from a browser view of the HTML. Data dictionary should also be generated as a PDF.

 

- Editable Source

The original editable source files were not included in the submitted file. From the XHTML it appears that the files were originally authored in MS Word. MS Word files were submitted for the CD member ballot.

 

Filenames

- Legal Characters

The submitted documents contain illegal spaceband characters in the filenames. The files must be renamed using conventions described here: http://docs.oasis-open.org/specGuidelines/namingGuidelines/resourceNaming.html#nameCharacters

 

- Construction

 

Namespaces

- Approved Format

   - URL

   - URN

The namespace uses 'evs' as the tc abbreviation; the proper tc abbreviation is 'election'. If this namespace has been in use in prior versions, it is hereby grandfathered.

 

- Namespace Document

Not required.

 

Schemas and XML Instances

- Separate Files

OK

 

- Valid / Well-Formed

No statement included in the PR request. (Submitter to certify that all schemas/xml instances are valid/well-formed)

 

- Copyright line

The standard OASIS Copyright line is to be included in each schema file. While not required, the TC may also wish to include some other metadata such as TC name, Specification Version.

 

Contributors

- Approved by Members

- Organizational Affiliation

   - Organizational Members

   - Individuals/Associates

The following members as Associate Members and are not entitled to have their organizations recognized per the membership agreement. Instead, they should be noted as 'Associate'

John Ross

Paul Spencer

Peter Zelechoski

 

References

- Normative

OK

 

- Non-Normative

Not properly formatted; unclear where actually referenced in the text of the specifications.

 

Other

Suggest noting each of the components under "Related Work" (i.e. Process and Data Requirements notes Schema Descriptions and Data Dictionary; Schema Descriptions notes Process and Data Requirements and Data Dictionary)

 

 

Regards,

 

Mary

 

---------------------------------------------------

Mary P McRae

Manager of TC Administration, OASIS

email: mary.mcrae@oasis-open.org  

web: www.oasis-open.org

phone: 603.232.9090

 

OASIS Symposium:
"eBusiness and Open Standards:
Understanding the Facts, Fiction, and Future"
15-18 April 2007 San Diego, CA USA
http://www.oasis-open.org/events/symposium/