OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [dita] Breaking 'Technical Content' specializations into two groups

This is interesting stuff particularly in light of the discussions that the Tech Comm SC was having last year. Scott Hudson had created a few new prototype domain modulesÂduring this process. One problem that we had identified was that the programming domain was often inadequate for marking up documentation relating to modern applications. Of course, the problem here is where do you stop? We had identified a few new domains related to programming that would be useful. But, stopping where we are in DITA 1.3 is not a good answer becauseÂthe industry has evolved from where it was when the programming domain was created, and you could argue that the programming domain omittedÂsemantics that should have been included when it was created. The point is that even within programming more domains are needed. These new domains will also not be of interest to a large portion of authors.

What do we do about domains that are preconfigured into the structural grammar files? Including all of them has already led to content model bloat. Chris's idea could serve as the basis for what gets preconfigured. Although, I have configured the grammar files that exclude one or more of the domains mentioned in the "utility" category.


The equation domain and theÂmathMLÂdomain fit better into the "utility" category because Mathematics is at least as general as the other domains that were identified as "utility".Â

Here are some points of clarification about troubleshooting. DITA 1.3 Troubleshooting enhancements were implemented in the DTDs as follows:
  1. Adding @type value "trouble" to <note> in commonElements.mod
  2. Adding <steptroubleshooting> and <tasktroubleshooting> to task.mod
  3. Adding a the troubleshooting topic type to the technical content package.
Item 1 belongs to the base, and items 2 and 3 are defined within structuralÂspecializations that would fall into the "utility" category.

Best regards,

On Tue, Jul 10, 2018 at 10:14 AM, Chris Nitchie <chris.nitchie@oberontech.com> wrote:

As I mentioned on the call today, Iâm suggesting that we break out the general-purpose modules currently labeled âTechnical Contentâ from the more industry-specific domains also included in that package. Hereâs how Iâd organize it:


General-purpose âutilityâ modules, not particularly bound to any industry, vertical, or classification:

  • Concept
  • Reference
  • Task/General Task/taskreq domain
  • Glossary-related domains
  • Bookmap (and/or the new DITA 2.0 bookmap)
  • Abbreviation domain
  • Release management domain
  • Troubleshooting domain
  • SVG Domain


More specific, technology-related specializations:


  • Equation domain
  • Markup and XML Mention domains
  • MathML domain
  • Programming domain
  • Software domain
  • UI Domain



Bob Thomas
+1 720 201 8260
Skype: bob.thomas.colorado
Instant messaging: Gmail chat (bob.thomas@tagsmiths.com) or Skype
Time zone: Mountain (GMT-7)

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]