[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Questions about your comments on CD 02 submission
Hi, Mary. I haven't back from you, so I'm going to telephone you this morning. Is (603) 232-9090 your work phone number? I don't want to touch on the namespace issue -- I'm leaving that in Don Day's hands -- but I do want to ensure that I clearly understand all of the other points so that we can avoid the sort of churn that we've been experiencing. I also want to check with you about the appendices. The draft of the DITA 1.2 spec that the TC approved as CD 03 has the following structure (which I implemented based on the design shown in the OASIS template at http://docs.oasis-open.org/templates/OASISSpecificationTemplateV4.1.html#AB): Do you want each appendix topic -- for example, B.1, B.1.1, and B.1.2 -- starting on a separate page with a Level 1 header? Or should only Appendix A and Appendix B be treated that way? Looking forward to your help in resolving these final formatting issues, Kris Kristen James Eberlein Principal consultant, Eberlein Consulting Secretary, OASIS DITA Technical Committee Charter member, OASIS DITA Adoption Committee www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) -------- Original Message --------
Hi, Mary. Please see my comments or questions below in <kje> tags. Kris BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite"><kje>Help me understand, since I obviously misunderstood your earlier comments. Is it the case that the links in the "This version" section always point to a specific version -- cd01, cd02, cs -- but the links in the "Latest version" section always are the generic URIs? If so, is the following what you want in the "This version" section?" http://docs.oasis-open.org/dita/v1.2/cd02/spec/DITA1.2-spec.html (Authoritative version) http://docs.oasis-open.org/dita/v1.2/cd02/spec/DITA1.2-spec.pdf http://docs.oasis-open.org/dita/v1.2/cd02/spec/DITA1.2-spec-chm.zip http://docs.oasis-open.org/dita/v1.2/cd02/spec/DITA1.2-spec.zip </kje> BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite"> <kje>By "actual hypertext link," do you mean a link to what you call the "namespace document"? If so, where do you want to locate the "namespace document"? Give us a URL, and we will reference it. (I am not sure why you mention the focus area.) The nomenclature is problematic, since the actual "Declared XML namespace" is xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/" Perhaps this section should be retitled "Location of OASIS namespace document"?</kje> BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite"><kje>I'll open an action item to correct this aspect of the PDF formatting.</kje> BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite"><kje>I am reluctant to have a lengthy list of appendices which would be at the same level as major content. For example, if I followed your suggestion, the TOC would look like this: Introduction Architecture specification Language reference Conformance Appendix A Appendix B Appendix C Appendix D Appendix E Appendix F Appendix H Appendix I Appendix J Instead, I'll reorganize the material as follows, which provides a better alignment with the OASIS specification template: Introduction Architecture specification Language reference Non-normative information Conformance Appendix A. Acknowledgments Please let me know ASAP if you think such a reorganization will require a new TC vote. </kje> BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite"> BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite"> BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite"> |
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]