-
Type:
60-day Public Review
-
Status:
Closed
-
Priority:
Major
-
Resolution:
Applied
-
-
The following request has been submitted to the OASIS TC Administrator on 16/06/2010:
>
>
Submitter's Name
Kristen James Eberlein
TC Name
Darwin Information Typing Architecture
TC Email Address
[1]dita@lists.oasis-open.org
Specification Title
Darwin Information Typing Architecture (DITA) Version 1.2
Resources
[2]http://www.oasis-open.org/apps/org/workgroup/dita/download.php/38308/DITA1.2-CD02.zip
Approval Link
[3]http://lists.oasis-open.org/archives/dita/201006/msg00127.html
Abstract
The Darwin Information Typing Architecture (DITA) 1.2 specification defines both a) a set of document types for authoring and organizing topic-oriented information; and b) a set of mechanisms for combining, extending, and constraining document types.
Notes
Please note that the minutes do not accurately reflect the TC decision. We have requested the following emendation:
>
> 7. ITEM: Vote on acceptance of CD for public review
> http://lists.oasis-open.org/archives/dita/201006/msg00110.html
>
> Voting members on the TC call each were polled and each voted "Aye" to approve the most current version of the DITA 1.2 spec as a committee draft for submission to OASIS for public review. The CD will be named per OASIS naming policies. The document has been uploaded to Kavi in XHTML, CHM, PDF, and DITA source; the authoritative version (XHTML) that was voted on is located at http://www.oasis-open.org/committees/download.php/38289/DITA1.2-spec-xhtml.zip/DITA1.2-spec-html.zip
>
> Thank you for your request. We will schedule the QC review shortly. You can follow the progress at:
> http://tools.oasis-open.org/issues/browse/TCADMIN
>
> The Standards Development team.
----------------------------------------------------------------------------------------
[1] dita@lists.oasis-open.org
[2] http://www.oasis-open.org/apps/org/workgroup/dita/download.php/38308/DITA1.2-CD02.zip
[3] http://lists.oasis-open.org/archives/dita/201006/msg00127.html
{"report":{"apdex":0.5,"isInitial":true,"journeyId":"49b76481-50ac-4c7b-87fc-8f9049da6675","key":"jira.project.issue.view-issue","navigationType":0,"readyForUser":2447.899999976158,"redirectCount":0,"resourceLoadedEnd":2226,"resourceLoadedStart":600.6999999880791,"resourceTiming":[{"duration":36.80000001192093,"initiatorType":"link","name":"https://issues.oasis-open.org/s/3edeca31ab9ba77980aae0809fbe7121-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/0a4716d29b2d5b1bdcdb168b4efc119e/_/download/contextbatch/css/_super/batch.css","startTime":600.6999999880791,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":600.6999999880791,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":637.5,"responseStart":0,"secureConnectionStart":0},{"duration":38,"initiatorType":"link","name":"https://issues.oasis-open.org/s/7d2823769c2e7b66e860863fe879b7f8-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/9aebb1c0aaa4c36289529757ec9dbb54/_/download/contextbatch/css/project.issue.navigator,jira.view.issue,jira.global,atl.general,-_super/batch.css?agile_global_admin_condition=true&jag=true&jira.create.linked.issue=true&richediton=true","startTime":601.0999999940395,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":601.0999999940395,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":639.0999999940395,"responseStart":0,"secureConnectionStart":0},{"duration":38.80000001192093,"initiatorType":"link","name":"https://issues.oasis-open.org/s/d41d8cd98f00b204e9800998ecf8427e-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/8.0.5/_/download/batch/com.atlassian.auiplugin:split_aui.pattern.label/com.atlassian.auiplugin:split_aui.pattern.label.css","startTime":601.2999999821186,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":601.2999999821186,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":640.0999999940395,"responseStart":0,"secureConnectionStart":0},{"duration":39.80000001192093,"initiatorType":"link","name":"https://issues.oasis-open.org/s/645acc233eb869f48a571293b8358a7d-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:global-static-adgs/jira.webresources:global-static-adgs.css","startTime":601.3999999761581,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":601.3999999761581,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":641.1999999880791,"responseStart":0,"secureConnectionStart":0},{"duration":42,"initiatorType":"link","name":"https://issues.oasis-open.org/s/a0dd6509771c1de0667aae5429c04cda-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:global-static/jira.webresources:global-static.css","startTime":601.5999999940395,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":601.5999999940395,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":643.5999999940395,"responseStart":0,"secureConnectionStart":0},{"duration":1299.9000000059605,"initiatorType":"script","name":"https://issues.oasis-open.org/s/e5479157e7a0c08b005e6522f2f04104-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/0a4716d29b2d5b1bdcdb168b4efc119e/_/download/contextbatch/js/_super/batch.js?locale=en-US","startTime":601.7999999821186,"connectEnd":734.5999999940395,"connectStart":647.7999999821186,"domainLookupEnd":647.7999999821186,"domainLookupStart":647.7999999821186,"fetchStart":601.7999999821186,"redirectEnd":0,"redirectStart":0,"requestStart":734.5999999940395,"responseEnd":1901.699999988079,"responseStart":781.7999999821186,"secureConnectionStart":691},{"duration":1624.1000000238419,"initiatorType":"script","name":"https://issues.oasis-open.org/s/83514d5d4e8543747b02042eafcdc99c-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/9aebb1c0aaa4c36289529757ec9dbb54/_/download/contextbatch/js/project.issue.navigator,jira.view.issue,jira.global,atl.general,-_super/batch.js?agile_global_admin_condition=true&jag=true&jira.create.linked.issue=true&locale=en-US&richediton=true","startTime":601.8999999761581,"connectEnd":730.8999999761581,"connectStart":645.3999999761581,"domainLookupEnd":645.3999999761581,"domainLookupStart":645.3999999761581,"fetchStart":601.8999999761581,"redirectEnd":0,"redirectStart":0,"requestStart":731,"responseEnd":2226,"responseStart":777.7999999821186,"secureConnectionStart":687.1999999880791},{"duration":188.69999998807907,"initiatorType":"script","name":"https://issues.oasis-open.org/s/70bb2263e59e7e1f04fbd137c80b895b-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/aae1242f5fc81cc6a5bb8bc963ccda29/_/download/contextbatch/js/atl.global,-_super/batch.js?locale=en-US","startTime":602.0999999940395,"connectEnd":736,"connectStart":646,"domainLookupEnd":646,"domainLookupStart":646,"fetchStart":602.0999999940395,"redirectEnd":0,"redirectStart":0,"requestStart":736,"responseEnd":790.7999999821186,"responseStart":788.6999999880791,"secureConnectionStart":690},{"duration":188.40000000596046,"initiatorType":"script","name":"https://issues.oasis-open.org/s/d41d8cd98f00b204e9800998ecf8427e-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:calendar-en/jira.webresources:calendar-en.js","startTime":602.1999999880791,"connectEnd":737.2999999821186,"connectStart":647.6999999880791,"domainLookupEnd":647.6999999880791,"domainLookupStart":647.6999999880791,"fetchStart":602.1999999880791,"redirectEnd":0,"redirectStart":0,"requestStart":737.2999999821186,"responseEnd":790.5999999940395,"responseStart":789.7999999821186,"secureConnectionStart":691.3999999761581},{"duration":184.7000000178814,"initiatorType":"script","name":"https://issues.oasis-open.org/s/d41d8cd98f00b204e9800998ecf8427e-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:calendar-localisation-moment/jira.webresources:calendar-localisation-moment.js","startTime":602.2999999821186,"connectEnd":738.1999999880791,"connectStart":650.3999999761581,"domainLookupEnd":650.3999999761581,"domainLookupStart":650.3999999761581,"fetchStart":602.2999999821186,"redirectEnd":0,"redirectStart":0,"requestStart":738.2999999821186,"responseEnd":787,"responseStart":786.1999999880791,"secureConnectionStart":694.1999999880791},{"duration":188.10000002384186,"initiatorType":"script","name":"https://issues.oasis-open.org/s/cda37faab827dbdf305de8efe8282062-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/8.0.5/_/download/batch/com.atlassian.auiplugin:split_aui.pattern.label/com.atlassian.auiplugin:split_aui.pattern.label.js?locale=en-US","startTime":602.3999999761581,"connectEnd":739.1999999880791,"connectStart":650.1999999880791,"domainLookupEnd":650.1999999880791,"domainLookupStart":650.1999999880791,"fetchStart":602.3999999761581,"redirectEnd":0,"redirectStart":0,"requestStart":739.1999999880791,"responseEnd":790.5,"responseStart":789.2999999821186,"secureConnectionStart":693.6999999880791},{"duration":46.599999994039536,"initiatorType":"link","name":"https://issues.oasis-open.org/s/07245784f53abc49bad9d9d4d36c577a-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/cadc4f20cc5c138dee060d42cf85f220/_/download/contextbatch/css/jira.global.look-and-feel,-_super/batch.css","startTime":602.6999999880791,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":602.6999999880791,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":649.2999999821186,"responseStart":0,"secureConnectionStart":0},{"duration":365.59999999403954,"initiatorType":"script","name":"https://issues.oasis-open.org/rest/api/1.0/shortcuts/803004/bd451b0923ea64bd27375a5c43348fc3/shortcuts.js?context=issuenavigation&context=issueaction","startTime":602.7999999821186,"connectEnd":919.7999999821186,"connectStart":791.1999999880791,"domainLookupEnd":791.1999999880791,"domainLookupStart":791.1999999880791,"fetchStart":602.7999999821186,"redirectEnd":0,"redirectStart":0,"requestStart":919.8999999761581,"responseEnd":968.3999999761581,"responseStart":967.5999999940395,"secureConnectionStart":875.6999999880791},{"duration":42.80000001192093,"initiatorType":"link","name":"https://issues.oasis-open.org/s/f77fd89aa211a76b20e9b0e63564383c-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/4a9288299d147101bf66484f4be48925/_/download/contextbatch/css/com.atlassian.jira.projects.sidebar.init,-_super,-jira.view.issue,-project.issue.navigator/batch.css?jira.create.linked.issue=true&richediton=true","startTime":608.2999999821186,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":608.2999999821186,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":651.0999999940395,"responseStart":0,"secureConnectionStart":0},{"duration":380.80000001192093,"initiatorType":"script","name":"https://issues.oasis-open.org/s/41525c48ddceeb9b11e54085268fc285-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/4a9288299d147101bf66484f4be48925/_/download/contextbatch/js/com.atlassian.jira.projects.sidebar.init,-_super,-jira.view.issue,-project.issue.navigator/batch.js?jira.create.linked.issue=true&locale=en-US&richediton=true","startTime":608.6999999880791,"connectEnd":920,"connectStart":786.8999999761581,"domainLookupEnd":786.8999999761581,"domainLookupStart":786.7999999821186,"fetchStart":608.6999999880791,"redirectEnd":0,"redirectStart":0,"requestStart":920.1999999880791,"responseEnd":989.5,"responseStart":985.0999999940395,"secureConnectionStart":875.8999999761581},{"duration":359.39999997615814,"initiatorType":"script","name":"https://issues.oasis-open.org/s/d41d8cd98f00b204e9800998ecf8427e-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:bigpipe-js/jira.webresources:bigpipe-js.js","startTime":610.5,"connectEnd":920.2999999821186,"connectStart":791.0999999940395,"domainLookupEnd":791.0999999940395,"domainLookupStart":791.0999999940395,"fetchStart":610.5,"redirectEnd":0,"redirectStart":0,"requestStart":920.2999999821186,"responseEnd":969.8999999761581,"responseStart":969.1999999880791,"secureConnectionStart":875.5},{"duration":359.2000000178814,"initiatorType":"script","name":"https://issues.oasis-open.org/s/d41d8cd98f00b204e9800998ecf8427e-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:bigpipe-init/jira.webresources:bigpipe-init.js","startTime":611.7999999821186,"connectEnd":923.2999999821186,"connectStart":791.0999999940395,"domainLookupEnd":791.0999999940395,"domainLookupStart":791.0999999940395,"fetchStart":611.7999999821186,"redirectEnd":0,"redirectStart":0,"requestStart":923.3999999761581,"responseEnd":971,"responseStart":970.2999999821186,"secureConnectionStart":876.5},{"duration":171.5,"initiatorType":"xmlhttprequest","name":"https://issues.oasis-open.org/rest/webResources/1.0/resources","startTime":2085,"connectEnd":2209,"connectStart":2125.699999988079,"domainLookupEnd":2125.699999988079,"domainLookupStart":2125.699999988079,"fetchStart":2085,"redirectEnd":0,"redirectStart":0,"requestStart":2209.0999999940395,"responseEnd":2256.5,"responseStart":2255.7999999821186,"secureConnectionStart":2167}],"threshold":1000,"fetchStart":1,"domainLookupStart":13,"domainLookupEnd":245,"connectStart":245,"connectEnd":409,"secureConnectionStart":287,"requestStart":409,"responseStart":502,"responseEnd":601,"domLoading":506,"domInteractive":2547,"domContentLoadedEventStart":2547,"domContentLoadedEventEnd":2593,"domComplete":2688,"loadEventStart":2688,"loadEventEnd":2690,"userAgent":"Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)","marks":[],"measures":[],"correlationId":"f92059c1ece4af","effectiveType":"4g","downlink":9.1,"rtt":0,"serverDuration":96,"dbReadsTimeInMs":11,"dbConnsTimeInMs":14,"applicationHash":"4d4040e0714d65b7fffa4801569d014c0b16eaa9","experiments":[]}}
sent 27 May:
It looks like there's still a lot of white paper formatting happening rather than specification formatting.
Specification URIs title is missing.
Under This Version, please move the zips to the end and remove the note at the end of the DITA version. Include a readme.txt in the zip to let people know where to start.
Under Latest Version, a URI must be provided corresponding to each 'this version' URI.
In the Notices, please add "DITA" in the last paragraph (along with "OASIS")
Structurally:
Section 1 must include Terminology (including RFC 2119 language), Normative References, and Non-Normative References. This includes at least a normative reference to RFC 2119, and I'm guessing XML but maybe others as well. You can quickly view the formatting and citation here: http://docs.oasis-open.org/templates/OASISSpecificationTemplateV4.1.html
Section 1.2 History should go in the Appendix Revision History
Appendices must be labeled as such (and not as Section 5):
Appendix A Acknowledgements
Appendix B Change History
Appendix C Migrating ...
etc.
PDF Version:
cover page:
hypertext links for specification URIs don't look like links (they are, but they should be blue/underlined)
running footer:
no rule
left side:
spec ID (DITA v1.2 CD01)
copyright
right side:
approval date (dd month yyyy)
Page # of #
Notices and TOC starts a new page (same formatting as level 1 head)
running header:
no running header
text in all sections (1 - # and Appendices A - z):
should be flush left and not indented under section/subsection title
Note much of the text in the tables is illegible or overset:
All heads:
Should match the color used for the title and headings on the cover page.
Level 1 (Section) heads:
There should be a rule at the top of the page (OASIS color)
18pt bold Arial #66616D
Level 2 heads (#.#)
no rule
14pt bold Arial #66616D
Level 3 heads (#.#.#)
13pt bold Arial #66616D
Level 4 heads (#.#.#.#)
12pt bold Arial #66616D
Level 5 heads (#.#.#.#.#)
12pt bold Arial #66616D
Level 6 heads (#.#.#.#.#.#)
11pt bold Arial #66616D
Level 7 heads (#.#.#.#.#.#.#)
11pt bold Arial #66616D
Level 8 heads (#.#.#.#.#.#.#.#)
11pt italic Arial #66616D
Level 9 heads (#.#.#.#.#.#.#.#.#)
11pt roman Arial #66616D
HTML version:
page footer:
Please use DITA v1.2 CD01 instead of spec name as currently displayed
section/subsection numbers:
are missing
'parent' pages:
contain duplicated text
Navigation Links:
should also include 'previous' and 'next' rather than just 'parent topic' and 'previous topic'. For instance, if I'm at 2.1.1.1 I need to be able to get to 2.1.1.2 and should not have to go back to 2.1.1. 'next' should get me from beginning to end.