Specification Submission for EDXL-RM

Hi Tim, Elysa, et al

 

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

 

Submitted 
file(s):

EDXL-RM-SPEC-V1.0.html

EDXL-RM-SPEC-V1.0.doc

EDXL-RM-SPEC-V1.0.pdf

EDXL-rm-cd-v01_files (for 
html)

EDXL-RM-SchemasAndExamplesV1 (dir containing schemas 
and example files)

 

Metadata

- Specification 
Title and Version

not formatted properly; should 
say:

Emergency Data Exchange Language Resource Messaging 
(EDXL-RM) Version 1.0

- Stage and 
Revision

stage is to appear on a separate 
line

- 
Date

date is to appear on a separate 
line

- 
URIs

1. the same path is given for both the current and 
latest version; this was correct before and is now 
incorrect

i.e., use http://docs.oasis-open.org/emergency/edxl-rm/v1.0/cd01/EDXL-RM-SPEC-V1.0.doc for the "this version" and use http://docs.oasis-open.org/emergency/edxl-rm/v1.0/EDXL-RM-SPEC-V1.0.doc for the "latest 
version"

2. only the doc files are listed; must list all 3 
versions (pdf, html, doc)

- TC 
Name

this should be a hypertext link to the TC Public Home 
page

- 
Chair(s)

OK

- 
Editor(s)

OK

- Related 
Work

These should be hypertext linked to the actual 
documents

- 
Namespaces

OK

- 
Abstract

OK

 

Boilerplate

- 
Status

Status boilerplate not up-to-date (remove last sentence 
1st para)

2nd paragraph incorrectly identifies sending a comment 
to a subcommittee list. Comment lists are for TCs 
only.

3rd paragraph incorrectly identifies IPR for a 
subcommittee; IPR is maintained at the (official) Committee Level and must point 
to the TC IPR page.

Errata paragraph has been omitted and must be added 
backin.

   - IPR 
URI

incorrect URI

   - 
Comment URI

incorrect URI

   - 
Errata URI

not listed

- 
Notices

   - 
Legacy / Current

OK

   - 
Trademark Terms

OK

   - 
Copyright line

OK

 

Hyperlinks

There are numerous hypertext links in Sections 1 
and 2 that point to member-only URIs. These must be changed to point to 
publicly-accessible URIs.

- 
Activated

all URIs should be 'activated'; that is, 
clickable

- Appropriate Link 
Targets

please ensure that the actual hypertext link matches 
the text printed in the document

 

Footers

- Document 
Identifier

OK

- 
Copyright

OK

- 
Date

improper format; should be DD Month 
YYYY

- Page 
Numbers

OK

 

Layout

- OASIS 
Logo

OK

- Page 
Layout

OK; legibility of the schema files could be improved by decreasing the 
indent to '1' rather than '4'; numerous awkward linewraps. Also, 
point size can be reduced to aid 
readability 

- 
Colors

there are a couple of places early in the document that 
appear in orangey/yellow text. Please change to 
black.

- Typestyle

OK, TOC is in an odd 
typeface

 

Formats

- 
XHTML

HTML Submitted; TCAdmin to 
convert

- 
PDF

yes

- Editable Source

yes

 

Filenames

- Legal 
Characters

OK

- 
Construction

OK

NOTE that the folder for the HTML graphics no longer 
matches the name of the HTML document; I think this will result in broken 
references. The HTML graphic folder should be regenerated along with the HTML 
once the document has been corrected.

 

Namespaces

- Approved 
Format

   - 
URL

   - 
URN

OK

- Namespace 
Document

Not required for URN 
namespaces

 

Schemas and XML 
Instances

- Separate 
Files

OK; Appendix A should note schemas 
are included for reference only and the normative schemas can be found at http://docs.oasis-open.org/emergency/edxl-rm/v1.0/cd01/schemas/

- Valid / 
Well-Formed

No certification received; TC Admin did not 
double-check

- Copyright 
line

Not included in schemas

 

Contributors

- Approved by 
Members

- Organizational 
Affiliation

   - 
Organizational Members

   - 
Individuals/Associates

The following people should be listed as either 
Individual or Associate Member; their company affiliations should not be 
listed.

Kurt Buehler

Sukumar 
Dwarkanath

Adam 
Hocek

Michelle 
Raymond

 

References

- 
Normative

OK

- 
Non-Normative

OK

 

Other

None.

 

 

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

Mary P McRae

Manager of TC Administration, 
OASIS

email:  
 

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/