Fw: [dita] DITA users want more (and better) examples

[Keith Schengili-Roberts <keith.roberts@ixiasoft.com>]

I am going to go digging for comments from previous listening sessions on code examples, but I thought it would be a good idea to pass this along. It would be good to ask the audience specific questions relating to what Kris has to say below.

Cheers!

 

-

Keith Schengili-Roberts

Market Researcher and DITA Evangelist

 

IXIASOFT 

825 Querbes, Suite 200, Montréal, Québec, Canada, H2V 3X1

tel  + 1 514 279-4942  /  toll free + 1 877 279-4942 

robertsk@ixiasoft.com  /  www.ixiasoft.com

---

From: dita@lists.oasis-open.org <dita@lists.oasis-open.org> on behalf of Kristen James Eberlein <kris@eberleinconsulting.com>
Sent: September 18, 2018 9:50 AM
To: DITA TC
Subject: [dita] 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 ...

--
Best,
Kris

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

--------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php