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: [dita] Stage two: Issue #297 Allow example in more places

Hi, Scott.

I think you need to do some additional work on the "Example" section.

At a minimum, I want to see an easy-to-understand code sample that is introduced by with text explaining what the code sample illustrates. Remember that these proposals are:

  • Published and read by folks other than TC members
  • Used as basis for the forthcoming spec
  • Used as basis for presentations about DITA 2.0

If you are expecting that <example> in new places will have any auto-generated text or styling, it's good to include examples of that also.

You also should consider having multiple examples, given the many new places that this proposal will permit <example>.


Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
+1 919 622-1501; kriseberlein (skype)

On 10/2/2019 8:41 AM, Scott Hudson wrote:

Please find attached the PDF of the stage two proposal: Issue #297  Allow example in more places

I'd like to formally discuss this proposal at the next TC meeting.

Corresponding DITA source at:

Reviewed by:
Kris Eberlein
Carlos Evia
Joyce Lam

Thanks and best regards,
Scott Hudson
Content Technology Strategist, DS&A Information and Knowledge Services
Jeppesen, A Boeing Company
55 Inverness Drive East
Englewood, CO 80112
http://www.jeppesen.com <http://www.jeppesen.com/>

To unsubscribe from this mail list, you must leave the OASIS TC that 
generates this mail.  Follow this link to all your TCs in OASIS at:

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