This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
Re: [docbook-apps] DocBook for Test Plans
- From: "Hwei Chan" <hwei at jsoft dot net dot nz>
- To: M Flood <mdflood at starpower dot net>,"DocBookApps" <docbook-apps at lists dot oasis-open dot org >
- Date: Thu, 20 May 2004 15:09:01 +1200
- Subject: Re: [docbook-apps] DocBook for Test Plans
- References: <20040520012147.M44042@jsoft.net.nz> <40AC0B2D.1090400@starpower.net>
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 -------
To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org, or visit http://www.oasis-open.org/mlmanage/.