RE: [GD-Design] Design Documents

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

> We have used Lotus Notes to manage databases of related design
> documents, and anyone on the team can maintain them.
>
> If I were starting over right now, I'd probably find a way to use XML to
> create a standard document format, and check the XML docs into a source
> code repository, and use stylesheets to format them for viewing and
> printing.
>
> But in any case, think of your design docs as a database of related
> items, rather than one big document, and impose some standard formatting
> on them, and you'll be a lot happier as the design grows.

That's what we've been considering. Our current design doc is about 250
pages spread over about 10 docs at the moment (and it will be a lot bigger
when it's finished) and it's very unwieldy.

Some sort of web based document is looking a reasonable solution, my only
concern is getting the control for printed versions.

Phil