OASIS Darwin Information Typing Architecture (DITA) TC

Tom,




Not to self-promote, but the Titania Delivery demo portal has been pulling the latest 1.3 stuff out of SVN nightly for a while now. The new artwork is visible in these topics (and look great, IMHO):




About: Overview About: Base About: Technical Content About: All-Inclusive Formatting conventions in the XHTML version of the specification
Overview of document-type shells Addressing keys across scopes Example: Key definitions in nested key scopes Release management domain
<imagemap>
A learning objects approach to learning and training content






Chris Nitchie
(734) 330-2978
chris.nitchie@oberontech.com
www.oberontech.com







Follow us:











 















From: < dita@lists.oasis-open.org > on behalf of Tom Magliery
Date: Tuesday, August 4, 2015 at 9:43 PM
To: DITA TC
Subject: [dita] Graphics overhaul - status








I have completed revising all of the graphics in the 1.3 spec. This is a comprehensive but "non-substantive/material" overhaul -- aesthetic updates only, although in several cases I made some alterations that I believe improve the clarity/understanding
of the original, without changing the essence.
 
It wouldn't hurt to have some eyes that are not mine to review all of the graphics, but I'm not sure what would be a convenient way to do that. I think this would be a somewhat urgent task -- needing to have any subsequent revisions done
by the end of this week, maybe? (Kris? Robert?)
 
One thing I could and would do is simply email a copy of the new set to anyone who wants to see them, along with a list of the locations where the old ones can be viewed.
 
Or, if you have access to the SVN repository, everything's checked in.
 
This review would not be a difficult task, by the way. There are only 10 graphics in the largest ("all-inclusive") edition of the spec, and a grand total of 13 images to be examined. (13, not 10, because the "editions diagram" has four
versions--one for each edition plus the "overview" doc.)
 
mag

This is great, thanks Chris!   For anyone interested to compare (and please do), here are the corresponding links in the csd01 HTML version, to see the older versions of the graphics:   1.1 About the DITA specification: Overview 1.1 About the DITA specification: Base edition 1.1 About the DITA specification: Technical content edition 1.1 About the DITA specification: All-inclusive edition 1.5 Formatting conventions in the XHTML version of the specification 2.5.2.1 Overview of document-type shells 2.3.4.4 Addressing keys across scopes 2.3.4.10.8 Example: Key definitions in nested key scopes 2.7.2.4 Release management domain 3.5.3.3 <imagemap> 2.8.3 A learning objects approach to learning and training content   mag       From: Chris Nitchie [mailto:chris.nitchie@oberontech.com] Sent: Wednesday, August 05, 2015 6:35 AM To: Tom Magliery; DITA TC Subject: Re: [dita] Graphics overhaul - status   Tom,   Not to self-promote, but the Titania Delivery demo portal has been pulling the latest 1.3 stuff out of SVN nightly for a while now. The new artwork is visible in these topics (and look great, IMHO):   About: Overview About: Base About: Technical Content About: All-Inclusive Formatting conventions in the XHTML version of the specification Overview of document-type shells Addressing keys across scopes Example: Key definitions in nested key scopes Release management domain <imagemap> A learning objects approach to learning and training content Chris Nitchie (734) 330-2978 chris.nitchie@oberontech.com www.oberontech.com Follow us:         From: < dita@lists.oasis-open.org > on behalf of Tom Magliery Date: Tuesday, August 4, 2015 at 9:43 PM To: DITA TC Subject: [dita] Graphics overhaul - status   I have completed revising all of the graphics in the 1.3 spec. This is a comprehensive but "non-substantive/material" overhaul -- aesthetic updates only, although in several cases I made some alterations that I believe improve the clarity/understanding of the original, without changing the essence.   It wouldn't hurt to have some eyes that are not mine to review all of the graphics, but I'm not sure what would be a convenient way to do that. I think this would be a somewhat urgent task -- needing to have any subsequent revisions done by the end of this week, maybe? (Kris? Robert?)   One thing I could and would do is simply email a copy of the new set to anyone who wants to see them, along with a list of the locations where the old ones can be viewed.   Or, if you have access to the SVN repository, everything's checked in.   This review would not be a difficult task, by the way. There are only 10 graphics in the largest ("all-inclusive") edition of the spec, and a grand total of 13 images to be examined. (13, not 10, because the "editions diagram" has four versions--one for each edition plus the "overview" doc.)   mag

Tom and Chris, thank you both for making the new and old versions easy to compare. Tom, the new ones are really an improvement, and in the case of some, especially the doctype shell, key scopes, and release mgmt, make the concept much easier to understand than it was before.  I always wonder about images with colors and how color-blind folks can relate to them, and the imagemap graphic makes good use of shapes to supplement the colors, so I think that will make it usable by them as well. Chris, I did notice that under the section "Navigation Links' in  Formatting conventions in the XHTML version of the specification , it says "When readers hover over the navigation links, the short description of the DITA topic also is displayed. "  But the navigation in the page itself (e.g. the 'Parent topic' link) does not display hoverhelp.  I know this Titania version isn't the 'official XHTML version of the specification' being described, but you might want to mimic that part of it. Anyway, kudos to you both, and thanks. Nancy _____________ Nancy Harrison Infobridge Solutions  nharrison@infobridge-solutions.com On Wed, Aug 5, 2015 at 12:21 PM, Tom Magliery < tom.magliery@justsystems.com > wrote: This is great, thanks Chris!   For anyone interested to compare (and please do), here are the corresponding links in the csd01 HTML version, to see the older versions of the graphics:   1.1 About the DITA specification: Overview 1.1 About the DITA specification: Base edition 1.1 About the DITA specification: Technical content edition 1.1 About the DITA specification: All-inclusive edition 1.5 Formatting conventions in the XHTML version of the specification 2.5.2.1 Overview of document-type shells 2.3.4.4 Addressing keys across scopes 2.3.4.10.8 Example: Key definitions in nested key scopes 2.7.2.4 Release management domain 3.5.3.3 <imagemap> 2.8.3 A learning objects approach to learning and training content   mag       From: Chris Nitchie [mailto: chris.nitchie@oberontech.com ] Sent: Wednesday, August 05, 2015 6:35 AM To: Tom Magliery; DITA TC Subject: Re: [dita] Graphics overhaul - status   Tom,   Not to self-promote, but the Titania Delivery demo portal has been pulling the latest 1.3 stuff out of SVN nightly for a while now. The new artwork is visible in these topics (and look great, IMHO):   About: Overview About: Base About: Technical Content About: All-Inclusive Formatting conventions in the XHTML version of the specification Overview of document-type shells Addressing keys across scopes Example: Key definitions in nested key scopes Release management domain <imagemap> A learning objects approach to learning and training content Chris Nitchie (734) 330-2978 chris.nitchie@oberontech.com www.oberontech.com Follow us:         From: < dita@lists.oasis-open.org > on behalf of Tom Magliery Date: Tuesday, August 4, 2015 at 9:43 PM To: DITA TC Subject: [dita] Graphics overhaul - status   I have completed revising all of the graphics in the 1.3 spec. This is a comprehensive but "non-substantive/material" overhaul -- aesthetic updates only, although in several cases I made some alterations that I believe improve the clarity/understanding of the original, without changing the essence.   It wouldn't hurt to have some eyes that are not mine to review all of the graphics, but I'm not sure what would be a convenient way to do that. I think this would be a somewhat urgent task -- needing to have any subsequent revisions done by the end of this week, maybe? (Kris? Robert?)   One thing I could and would do is simply email a copy of the new set to anyone who wants to see them, along with a list of the locations where the old ones can be viewed.   Or, if you have access to the SVN repository, everything's checked in.   This review would not be a difficult task, by the way. There are only 10 graphics in the largest ("all-inclusive") edition of the spec, and a grand total of 13 images to be examined. (13, not 10, because the "editions diagram" has four versions--one for each edition plus the "overview" doc.)   mag