Re: [dita] Purpose of files in the scott-example-sandbox directory

[Eliot Kimber <ekimber@contrext.com>]

The test documents that I've created are in the doctypes/test directory in
SVN (and now in the dita-rng-converter project on GitHub).

I haven't removed them from SVN yet because they may still have value as
test cases independent of how the grammars come to be produced
(automatically or manually).

The positive (valid) tests provide at least minimal smoke testing of all
the shells and new 1.3 vocabulary. The negative (invalid) tests are much
less complete and I still don't have a good way to run those tests in a
way that works with normal success/failure checking in Ant, although I
haven't had any time to work on it either.

I think the TC should maintain test documents: that seems like a minimal
bit of diligence for any vocabulary one develops.

Cheers,

E. 
—————
Eliot Kimber, Owner
Contrext, LLC
http://contrext.com




On 3/31/15, 11:32 AM, "Hudson, Scott" <scott.hudson@comtech-serv.com>
wrote:

>I still think these could be useful for validation and testing for 1.3,
>though they may need to be updated to reference the 1.3 schemas. Where
>are the validated examples for 1.3 currently stored? I hate to remove the
>files if they can still be of use.
> Since these are directly from the spec (though now valid), why couldn’t
>these be part of the official material?
>
>
>—Scott
>
>
>
>
>
>From: Robert D Anderson
>Date: Tuesday, March 31, 2015 at 10:13 AM
>To: Scott Hudson
>Cc: Kristen James Eberlein, "dita@lists.oasis-open.org"
>Subject: Re: [dita] Purpose of files in the scott-example-sandbox
>directory
>
>
>
>Hi Scott,
>
>I'm still not sure what these files are for now? They are not part of the
>DITA 1.3 creation, review, or delivery, so I think SVN is probably not
>the right place for them. I'm nervous about them causing confusion when
>others start looking for official material,
> as we had with some of the extra files in the doctypes\ directory a few
>weeks back.
>
>Also, as a related note, I think the bad examples from 1.2 have been
>corrected. They were never tested for XML (or DITA) validity during the
>1.2 process, which is something we corrected for 1.3, resulting in tweaks
>to quite a few of the code examples.
>
>Robert D Anderson
>IBM Authoring Tools Development
>Chief Architect, DITA Open Toolkit (http://www.dita-ot.org/)
>
>"Hudson,
> Scott" ---03/31/2015 10:44:17---Kris, et al, These files take all of the
>examples from the DITA 1.2 Specification (http://docs.oasis
>
>From: "Hudson, Scott" <scott.hudson@comtech-serv.com>
>To: Kristen James Eberlein <kris@eberleinconsulting.com>,
>"dita@lists.oasis-open.org" <dita@lists.oasis-open.org>
>Date: 03/31/2015 10:44
>Subject: Re: [dita] Purpose of files in the scott-example-sandbox
>directory
>Sent by: <dita@lists.oasis-open.org>
>
>________________________________________
>
>
>
>Kris, et al,
>
>These files take all of the examples from the DITA 1.2 Specification
>(http://docs.oasis-open.org/dita/v1.2/spec/DITA1.2-spec.html) and makes
>them valid XML samples.
>
>These were originally intended for use in testing the generated DTDs
>(from RNG). Eliot didn’t want individual element tests, but rather
>larger, complete examples, so he has used different test documents.
>
>These files can also be used for inclusion by reference as the examples.
>I still noticed quite a few “bad” xml examples in the specification, so
>this attempts to fix those issues.
>
>
>Still to do: 
>1. Learning and Training
>2. New DITA 1.3 elements
>
>
>Thanks and best regards,
>
>Scott Hudson
>Senior Consultant
>Comtech Services Inc.
>303-232-7586
>
>
>
>
>On 3/31/15, 8:37 AM, "Kristen James Eberlein"
><kris@eberleinconsulting.com> wrote:
>
>>Scott, what are these files intended for?
>>
>>Best,
>>Kris
>>
>>Kristen James Eberlein
>>Chair, OASIS DITA Technical Committee
>>Principal consultant, Eberlein Consulting
>>www.eberleinconsulting.com
>>+1 919 682-2290; kriseberlein (skype)
>>
>>On 3/30/2015 11:38 PM, workgroup_mailer@lists.oasis-open.org wrote:
>>> Author: scott.hudson1
>>> Date: 2015-03-31 03:38:35 +0000 (Tue, 31 Mar 2015)
>>> New Revision: 2356
>>> Web View: 
>>>https://tools.oasis-open.org/version-control/browse/wsvn/dita/?rev=2356&;
>>>sc=1
>>>
>>> Removed:
>>>     scott-examples-sandbox/abbreviated-form.001.ditamap
>>>     scott-examples-sandbox/anchorid.001.dita
>>> Log:
>>> Updates from 1.2 specification examples
>>>
>>> ---------------------------------------------------------------------
>>> 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:
>>> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
>>>
>>>
>>>
>>>
>>
>>
>>---------------------------------------------------------------------
>>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:
>>https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
>>
>
>
>
>
>
>
>
>---------------------------------------------------------------------
>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:
>https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php