OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

dita-adoption message

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

Subject: Difference between sample documents and a test suite

This is a question that arose at the last TC meeting, as we were glancing through a Wiki page created by Gershon and commented on by Paul Grosso.

I had some thoughts on this last night:

Sample documents are created to help people understand the capabilities of an architecture or product. They are designed to illuminate how something works and give people a clear understanding of what it can do.

A test suite is created to test compliance with an architecture or a set of criteria. They are designed to step products through test cases and uncover bugs and weaknesses.

So, the two items have very different audiences and purposes.

As a TC, I think we would be better off trying to focus on sample documents -- DITA source files -- which would help people understand the capabilities of the architecture.


Kristen James Eberlein
Principal consultant, Eberlein Consulting
Co-chair, OASIS DITA Technical Committee
Charter member, OASIS DITA Adoption Committee
+1 919 682-2290; kriseberlein (skype)

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