On Sat, Oct 13, 2001 at 10:58:44PM +0200, Emiliano wrote: > > If there would be a real source of information which is searchable in a > > good way and administered for actuality, a lot of questions wouldn't be > > asked. That means there would be more time for eliminating bugs and a > > faster development would be possible. If you read the mailinglist for a > > longer time, you will register that the same questions appear several > > times. In my opinion it's very important to change this. > > OK, so get in gear. Seriously. Writing documentation and keeping it up to > date is hard and takes lots of effort and time, and time is exactly what > I don't have much of. Also, as you may also have noted, the manual has > blind spots, and that's because _the developers have blind spots_. Things > that are trivial to us because we've spent the last 3 years working on > them get forgotten in the manual because we forget it can be an issue; > IOW, we _need_ a non-developer to work on the manual _precisely_ because > it's a non-spoiled, fresh look on the matter. > > Whoever decides to get the docs in shape can count on my full support > in doing so, and I assume Alexander feels the same way. See a > question asked and answered too many times? Pick my brain, write something > about it, put it in the docs. I fully agree with Emile. It is indeed an important issue to have a person who constantly tracks documentation and pins developers about changes. Being a professor of CS in near past I all for this. You can and definitely should use developers' minds for updating documentation and we (as developers) cannot be against it in any case. This is also an important issue in our case where English isn't main language for most of Midgard developers and share of knowledge for all users of Midgard is definitely limited by this as well.
-- / Alexander Bokovoy $ cat /proc/identity >~/.signature `Senior software developer and analyst for SaM-Solutions Ltd.` --- You're not Dave. Who are you? --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
