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: DITA users want more (and better) examples

This is what the DITA Adoption TC has heard at listening sessions.

I want to poke at this. Do we have any idea what DITA users mean when they say "We want more and better examples"? Before we try and jump to a solution, I think it would be helpful to define the problem.

I think the example issue might be multi-faceted and encompass a very wide range of of items:

  1. Some folks might want examples in the spec that reflect real world usage, not bats or puffins or garages.
  2. Some folks might want more examples to cover edge cases.
  3. Some folks might want more examples to illustrate what is handled by attributes on DITA elements.
  4. Some folks might want tutorials.
  5. Some folks might want access to more sets of sample files. (Not a DITA TC concern)

Let's also not forget that many users do not look at the spec at all ...


Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
+1 919 622-1501; kriseberlein (skype)

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