dita — archive

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

From: Tammy Crowley <[email protected]>
To: [email protected]
Date: Tue, 01 Nov 2022 14:51:00 -0000

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 [email protected] 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: [email protected] <[email protected]> On Behalf Of kris eberleinconsulting.com Sent: November 1, 2022 11:47 AM To: DITA Technical Committee ([email protected]) <[email protected]> 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 [email protected] Skype: kriseberlein; voice: +1 (919) 622-1501 From: Chet Ensign < [email protected] > Sent: Tuesday, November 1, 2022 10:41 AM To: kris eberleinconsulting.com < [email protected] > 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 < [email protected] > 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 [email protected] Skype: kriseberlein; voice: +1 (919) 622-1501 -- Chet Ensign Chief Technical Community Steward OASIS Open +1 201-341-1393 [email protected] www.oasis-open.org