Document Authors Reports Part 2 Mitch Gordon PDS

Document Authors’ Reports Part 2 Mitch Gordon PDS MC Meeting 2 -3 April 2013

Data Provider's Handbook • Philosophy o o o Write the Standards Reference first! Document how to prepare a PDS 4 archive Focus on representative topics Provide example fragments Refer to the PDS 4 example sets and PDS 4 & SBN wiki's • History o Original written by Ron Joyner o Multiple updates, but none recently. o Updates for paradigm shift away from "tailored schemas" and for consistency with IM 0. 3. 1. 0. a/b

Data Provider's Handbook • Outline (82 pages) o Preliminaries § Building Blocks § Schema & Labels – an Overview o First Steps § Outline the Bundle § Design Logical & Version Identifiers

Data Provider's Handbook • Outline (Continued) o Basic Product Labels § Basic Product Labels – Observational Products § Basic Product Labels – Non-Observational Products § Aggregate Product Labels § Label Template creation and editing

Data Provider's Handbook • Outline (continued) o Collections and Bundles § Collections § Bundles § Deliveries o Local Dictionaries and Other Documentation § Local Data Dictionary § Other Documentation

Data Provider's Handbook • Outline (continued) o Validation § PDS Validate Tool o Samples, Examples, Other Tutorials § PDS 4 Product Examples § PDS 4 Example Archive

Data Provider's Handbook • Outline (continued) o Appendix A – ACRONYMS o Appendix B – Schematron References o Appendix C – XML Catalog References o Appendix D – Steps to generate a label template in an XML aware editor from the master schema

Data Provider's Handbook • Status o Consistent with IM 0. 3. 1. 0. a/b o Will need continual revision as IM/DD stabilizes and tools are introduced or revised o Trouble areas: § Has not been current for awhile, so many of the revisions were fairly major with limited review. § Not much discussion of available tools § Balance (more or less on a given topic) will need to be adjusted with use