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 tammy@precisioncontent.com |
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: dita@lists.oasis-open.org <dita@lists.oasis-open.org>
On Behalf Of kris eberleinconsulting.com
Sent: November 1, 2022 11:47 AM
To: DITA Technical Committee (dita@lists.oasis-open.org) <dita@lists.oasis-open.org>
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
kris@eberleinconsulting.com
Skype: kriseberlein; voice: +1 (919) 622-1501
I don't have a problem with that. It is a great idea.
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
kris@eberleinconsulting.com
Skype: kriseberlein; voice: +1 (919) 622-1501
--
|
Chet Ensign
Chief Technical Community Steward
OASIS Open
|
|
|
|
|
|