RE: [GD-Design] Design Documents

[Loic B. <loi...@wa...>]

Ok, I also have a question concerning this topic! :)

Which program (and which file format) do you people use ??? We were firstly
using Word, but due to the size and the way it generates HTML code, we're
now using Frontpage...There's no grammatical correction ;) and few things
are missing, but it's working great with Common Style Sheet (css).

To answer to Phil, we're doing many many HTML pages. Each page use a CSS we
develop to reduce the size of the file, and to always have the possibility
to modify a given style with automatic change in all the pages. We'll maybe
use Microsoft Help Workshop to compile the whole into one big file, but I
dunno if it works with CSS...
Concerning the update of the doc, well, it's kinda wild...In theory, we
should update it each time a change is made in the source/design. But in
practice the change are made when we've finish a big coding/design part.

Well, the way we think about concerning documentation is still
evolving...With VS.Net and its dynamic help, things should be different
now..We're also working on a "Knowledge Base" tool that'll be used to
centralize knowledge that everyone have concerning one/many projects (brain
dumping/sharing tool :) ), but it's in progress, not finished yet.

Loic

> ----- Original Message -----
> From: "Matthew Newport" <Ma...@re...>
> To: <gam...@li...>
> Sent: Tuesday, November 06, 2001 3:31 PM
> Subject: RE: [GD-Design] Design Documents
>
>
> > I don't really have an answer to your questions but I have one to add
:-)
> >
> > How long and how detailed are people's design docs generally? I
personally
> > feel that our design docs could do with being a little longer and more
in
> > depth but I don't know how they compare to those used elsewhere in the
> > industry. I read in the Deus Ex post mortem that their design doc ran to
> > hundreds of pages, which is rather more detail than we have in ours...
> >
> > Matt.
> >
> > -----Original Message-----
> > From: Philip Harris [mailto:ph...@me...]
> > Sent: 06 November 2001 14:04
> > To: gam...@li...
> > Subject: [GD-Design] Design Documents
> >
> >
> > Two questions about design docs.
> >
> > Firstly, given that for a reasonable size project the design
> > doc is going to
> > exceed several hundred pages, how do people organise them.
> > Single word doc,
> > multiple word docs, HTML?
> >
> > Secondly, are these documents kept up to date and if so how?
> >
> > Or...does nobody bother with them in the first place.
> >
> > Phil
> >
> >
> > _______________________________________________
> > Gamedevlists-design mailing list
> > Gam...@li...
> > https://lists.sourceforge.net/lists/listinfo/gamedevlists-design
> >
>
> _______________________________________________
> Gamedevlists-design mailing list
> Gam...@li...
> https://lists.sourceforge.net/lists/listinfo/gamedevlists-design