Using dita-users to get folks to contribute examples for the spec

I like the idea a lot.
Examples are critical for providing additional context/supporting info.

Cheers,
Tammy

tammy crowley information architect 180 John St. Toronto, ON Canada M5T 1X5 T: (437) 317-0802 
This email and any files transmitted with it are confidential and intended solely for the use of the individual or entity to whom they are addressed.
If you are not the intended recipient you are notified that disclosing, copying, distributing or taking any action in reliance on the contents of this information is strictly prohibited.
Please notify us by return email if you have received this email in error.
©2022, Precision Content , Toronto, Ontario, Canada
From:  <>
On Behalf Of kris eberleinconsulting.com
Sent: November 1, 2022 11:47 AM
To: DITA Technical Committee () <>
Subject: [dita] Using dita-users to get folks to contribute examples for the spec

I ve been posting on dita-users recently and asking folks for how they use specific elements: <choicetable> and <properties>.
I ve gotten some great feedback, and so thought that we might have some mini-competitions
for folks to contribute examples.
The winner would be credited directly in the spec topic: This example contributed by Bugs Bunny, Acme Corporation.

I wanted to run this by OASIS before I posted to the TC list, and I ve gotten the OK from Chet.
So, what do you all think?

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Owner, Eberlein Consulting LLC

Skype: kriseberlein; voice: +1 (919) 622-1501
From: Chet Ensign < 
>

Sent: Tuesday, November 1, 2022 10:41 AM
To: kris eberleinconsulting.com < 
>
Subject: Re: Acknowledging non-OASIS contributors in spec for contributing examples

I don't have a problem with that. It is a great idea.

On Tue, Nov 1, 2022 at 10:38 AM kris
eberleinconsulting.com < 
> wrote:

Hi, Chet.

A time-consuming part of spec development is creating good examples.
Recently, I ve been posting on an online group and asking DITA users for how they are using
specific elements and for examples of their usage, if they can share them.
Some of what I ve gotten has been marvelous.

So, I m tempted to gamify this and kind of have a competition on the dita-users list for people to develop good examples for particular DITA elements.
Could we
acknowledge the folks directly in the body of the spec? For example, go to
https://dita-lang.org/dita-techcomm/langRef/technicalContent/stepsection.html and scroll to the bottom of the topic, where we d have a paragraph stating This example contributed by Bugs Bunny, Acme Corporation.
If we couldn t do that, we d list people
in the Acknowledgements topic.

Obviously, we d have to have the contributions come in through dita-comment

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Owner, Eberlein Consulting LLC

Skype: kriseberlein; voice: +1 (919) 622-1501

--
Chet Ensign
Chief Technical Community Steward
OASIS Open

+1 201-341-1393



www.oasis-open.org