On Thu, 15 Jul 1999, Aley Keprt wrote: > > > >4. The only person who knows what he's doing on it is Simon himself. > > > > > > That's the problem. At least a todo list and some changelogs would be > > > better than nothing. > > > > Personally I'd rather he spend time coding, than writing up useless > > documantation. And (I'm playing devil's advocate here, slightly) what > > makes you think it is any of your business how Simon chooses to spend his > > time? > > What? Useless documentation??? > Remember: DOCUMENTATION OS NEVER USELESS!!! > This applies to the long-term projects as SimCoupe, when many people > want to work on it. > Please read some books on software engineering, there you can see > some statistics from 60's-80's concerning on this fenomena. > Probably you will surprised how necessary documentation is.
%!$$ *&& Aley - look at the context. I'm not talking about documented code, I'm talking about a "todo list and some changelogs" which _you_ were asking for. Now, tell me; what good is it to you, right now, before the work is actually released, if Si puts up a web page saying something like: "Fixed a glitch in palette changing. Windows now minimise properly. Added .dsk.gz support in dialogs. To do: fix flag bug" etc etc I'm not saying it would be useless to him, but that it would be useless to anyone else. Without the source there's nothing you can do with that sort of text, and it's just wasting Si's time keeping it presentable. I imagine he *is* keeping his own notes and docs, but it would be a waste of his time, at the moment, to write those up in such a way that others could see and understand them. Aley - don't patronise me. I know exactly why documentation is useful to the developers of a project. But I wasn't talking about that sort of documentation; and even if I was, until the source is released, you don't need the docs because you're not involved with the development of Win32 SimCoupe. Get over it. Andrew -- -- Andrew Collier ([EMAIL PROTECTED]) -- My other -- http://mnemotech.ucam.org -- .sig is a -- Part 3 Materials Science, Cambridge -- PDF file --
