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: Re: Using dita-users to get folks to contribute examples for the spec


I like it.

 

Cheers,

 

E.

 

_____________________________________________

Eliot Kimber

Sr Staff Content Engineer

O: 512 554 9368

M: 512 554 9368

servicenow.com

LinkedIn | Twitter | YouTube | Facebook

 

From: dita@lists.oasis-open.org <dita@lists.oasis-open.org> on behalf of kris eberleinconsulting.com <kris@eberleinconsulting.com>
Date: Tuesday, November 1, 2022 at 9:55 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

[External Email]

 


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

 

From: Chet Ensign <chet.ensign@oasis-open.org>
Sent: Tuesday, November 1, 2022 10:41 AM
To: kris eberleinconsulting.com <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 <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
kris@eberleinconsulting.com

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

 


 

--

Image removed by sender.

Chet Ensign

Chief Technical Community Steward

OASIS Open

 

 

 

Image removed by sender.

+1 201-341-1393

Image removed by sender.

chet.ensign@oasis-open.org

Image removed by sender.

www.oasis-open.org

 



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