Re: [docbook-apps] DocBook for Test Plans

["Hwei Chan" <hwei@jsoft.net.nz>]

Hi Mark,

I'm not sure... if I were to write my own DTD for what I think a test plan 
should be, then as a second step, convert it back to a DocBook XML, wouldn't 
I be better off writing a variant of the DocBook DTD? So that my DTD is also 
mostly DocBook and provide a set of XSL stylesheets to transform my DocBook 
DTD variant into whatever format I think a testplan should look like.

Say if I were to do that, wouldn't it be better if I don't need to create any 
new tags and use straight DocBook DTD elements but provide XSL stylesheets to 
convert the standard DocBook XML into what I want... much like what the 
javahelp stylesheets are doing?

Just wondering if anyone has already tackled this issue and established a 
solution that everyone else can use.

I basically want to write test plans using XML DocBook (standard DTD if 
possible but am happy to use a variant) and generate HTML or PDFs from them 
which I can distribute to testers. They probably don't want to have anything 
to do with DocBook itself.

Thanks again.

Regards,
Hwei



---------- Original Message -----------
From: M Flood <mdflood@starpower.net>
To: Hwei Chan <hwei@jsoft.net.nz>
Sent: Wed, 19 May 2004 21:34:37 -0400
Subject: Re: [docbook-apps] DocBook for Test Plans

> Hwei:
> 
> DocBook is a documentation format, so that's what I'd emphasize: that
> is, try writing a small DTD that meets your test plan needs.  Then write
> a XSLT stylesheet to convert your testplan.xml into a DocBook document
> (for example, <testplan:testsuite> ==> <docbook:table>) for 
> publication/dissemination.  Would that work?
> 
> -- Mark
> 
> Hwei Chan wrote:
> 
> >Hi all,
> >
> >I'm looking at using DocBook to author and generate test plans for software
> >UAT testing.
> >
> >I'm just wondering what the best options are:
> >
> >1. Use the standard (standard DocBook XSL Stylesheets) Html, FO, etc... XSL
> >stylesheets to generate standard corresponding documents and use tags like
> >table, etc to author the plans.
> >Has anyone had success with this option and do the plans look reasonable 
like
> >professional test plan documents?
> >
> >I presume that people using this option will probably get different 
resulting
> >test plans as people will probably use different DocBook tags.
> >
> >2. Has someone created specific XML stylesheets for transforming normal XML
> >DocBook documents to test plans? If so are they available for use?
> >
> >3. Has someone created XML DocBook DTD variants specifically to author test
> >plans?
> >
> >4. If no to both 2 and 3, are there any plans or will it be worthwhile to 
add
> >test plans to the standard DocBook XSL Stylesheet distribution?
> >
> >Many thanks.
> >
> >Regards,
> >Hwei
> >
> >
> >To unsubscribe from this list, send a post to docbook-apps-
unsubscribe@lists.oasis-open.org, or visit http://www.oasis-
open.org/mlmanage/.
> >
> >
> >
> >
------- End of Original Message -------