RE: [GD-Design] Design Documents

[Philip H. <ph...@me...>]

> 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...

Have you been able to produce a professional looking printed version of the
design docs? I like the idea of the HTML based design doc but there seems to
be a problem when it comes to producing versions for publishers etc. Getting
a decent printed version seems like a lot of work. Having said that I may
just be behind on my HTML theory and really it's a lot more controllable
these days.

> 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.

How much of the design doc did you produce up front? Or is it being built as
the project progresses?

> 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.

Definitely a good idea, we've got plans to put something like this together
but we've not gotten beyond the "it will have a web interface" stage yet :)

Phil