Fw: Do You Have the DITA 1.3 Examples Assembled into a Map/Topic Structure?

Relating to the mention that Scott had pulled together a repository of all of the example code from the DITA 1.3 specification, I am passing this along (with his permission). It was mentioned at the last meeting that
 it might be a good idea for DITA Adoption to help work on expanding the list of examples in order to make them more robust. "Better examples" is a common refrain at the DITA Listening Sessions, which I believe makes this a  priority.

I think we might be able to provide some structure to what is here, and not only expand this ourselves, but also put out a call to the community to see if others might be willing to pitch in and help expand it and encapsulate
 best practices.

Let's discuss this at the next DITA Adoption meeting.

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 

  / 
www.ixiasoft.com

From: Scott Hudson <>

Sent: June 20, 2018 9:27 AM

To: Keith Schengili-Roberts

Subject: Re: Do You Have the DITA 1.3 Examples Assembled into a Map/Topic Structure?

 

Hi Keith,

 

I created topics for each example in the spec. They are located here:

http://tools.oasis-open.org/version-control/browse/wsvn/dita/trunk/scott-examples-sandbox/#_trunk_scott-examples-sandbox_

 

I haven’t pulled them into a single document for testing, however. Many of the map elements are in separate ditamaps so they could be tested independently.

 

The committee never caught on to this idea for testing, so many of the topics aren’t fully valid, as these examples are literally pulled from the spec, but xref or link to non-existent resources.

 

I’d still like to change that…

 

Hope this helps!

 

Thanks and best regards,

 

--Scott

 

Voting member:

Boeing Data Standards Technical Advisory Board

OASIS DocBook TC (Secretary), Publishers SC (Chair)

OASIS DITA TC, Tech Comm SC, LwDITA SC, Learning Content SC (Secretary)

OASIS DITA Adoption TC

OASIS Augmented Reality in Information Products (ARIP) TC

 

Scott Hudson

Content Strategist, Digital Aviation Learning and Development

Jeppesen, A Boeing Company

55 Inverness Drive East

Englewood, CO  80112

303-328-6228 | Cell: 303-350-7934

 

 

This document contains only administrative, uncontrolled data under U.S. International Traffic in Arms Regulations.

 

 

From:
Keith Schengili-Roberts <>

Date: Wednesday, June 20, 2018 at 7:18 AM

To: Scott Hudson <>

Subject: Do You Have the DITA 1.3 Examples Assembled into a Map/Topic Structure?

 

Hey there Scott:

 

Earlier, during today's meeting, I think you said that you had attempted to assemble all of the DITA 1.3 examples into a single document, is that correct?

 

If so, would you mind passing along what you have?

 

With all of the talk recently about hosting OASIS items on GitHub, and wondering if a proposal for beefing up a separately-maintained examples document(s) might be met with favour by the
 TC.

 

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 

  / 
www.ixiasoft.com