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
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
- 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.