Folks - as we discussed in the EDXL-HAVE SC meeting this afternoon we would like to use a different format for the Data Dictionary section of the standards document.
I have CC'ed Chet Ensign from the TC Admin as per Elysa's recommendation.
The approach that I recommend and that we agreed upon was to use an auto-generated document that is driven from the data in our XML Schema. This would mean that there should be no errors (barring a software glitch in OxygenXML) but there are a couple of issues to consider:
1. I can't generate a Word-compatible version so we can't cut and paste the content into the .docx standard file. I proposed that we would include the full PDF (sample attached) as an appendix and reference it in the Data Dictionary. This would need approval from the TC Admin for the format.
2. There may be come formatting issues. If you look at the attached PDF, there are a few images that go beyond the page (e.g. see page 8). We can make a fully browse-able website version available too though - it doesn't have that problem.
Here is a screenshot comparing a draft (ignore the highlights on the left side please) with the normal table and the generated XML Schema documentation on the right. I believe all of the fields and information that we need is there and it includes a pretty good diagram.
We'll have the ERM diagram as well (thanks to Patti!) and the rest is coming along well.
Thanks a ton for the great meeting. I'll send out the draft minutes in a moment.
cheers,
Darrell
--
Darrell O'Donnell, P.Eng.
OASIS EM-TC - Member
OASIS EM-TC HAVE SC - Co-Chair