Re: [generguide-devel] Re: Stable requirements

[Sean W. <se...@ya...>]

--- Cameron Shorter <ca...@sh...> wrote:
> On Sunday 14 Sep 2003 8:09 pm, Sean Wheller wrote:
> > I would like to base myself on what ever
> information
> > you can provide. Is the
> > anything else in addition to the requirements on
> SF
> > and the golas on your
> > Web Site? Please do send them.
> 
> Most of it is written in the requirements in the
> http://generguide.sf.net 
> site.
> There is still a few ideas I have that has not made
> it onto the site yet, but 
> I will try and get it on paper soon.

Look forward to it.

> 
> > My structure for an SRS is derived from IEEE Guide
> to
> > Software
> > Requirements Specifications (Std 830-1993). It
> will be
> > a single Docbook XML
> > file to start with.
> > <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML
> > V4.2//EN"
> 
> I just looked in google for Std 830-1993.  It seems
> you need to pay big $$$ to 
> get a copy of it!

:-) Yes. But as this is what I do for a living, I
normally have to shed a few $$$. While I cannot
legally distribute a copy of the standard. I can send
you a Template (DocBook XML). This is my standard
rendition of their SRS. So the outline is slightly
modified and is commented at each section. We will be
free to use the template without legal implication as
it is a work of my own, simply based on the
recommendations.

> While a think it is very important to use standards
> where possible, in an open 
> source project I think it is more important to only
> use free and open 
> standards.
> At work we are using Mil-Std-498.  It is available
> for free at: 
> http://www.pogner.demon.co.uk/mil_498/

I have no problem using MIL. There is no huge
difference between them. Just that in general MIL is a
little dated and does not fall nicely into place with
ISO std's such as ISO 18019.

> 
> Secondly, I suggest we use Simple Docbook XML
> instead of Docbook XML.  It has 
> a lower learning curve for potential editors.
> Would it be possible for you to use Simple Docbook
> instead?

I guess I can, but does it matter. Anyone who can
modify the SRS should be at a level where the have a
broader perspective of XML. If they are editing the
SRS I assume that they have at least an understanding
of XML, XSL, XPath, XInclude, XPointer etc.

But if you feel that sdocbook must be used, I will use
it. Though now I will have to create a new template
based on the sdocbook type.

Sean Wheller

__________________________________
Do you Yahoo!?
Yahoo! SiteBuilder - Free, easy-to-use web site design software
http://sitebuilder.yahoo.com