On Monday 01 November 2004 22:06, Lauri Watts wrote: > On Monday 01 November 2004 21.43, Philip Rodrigues wrote: > > Hi Raphael, Alex, > > Just to respond briefly to your comments about developer docs: We've > > traditionally kept end-user and developer documentation quite separate, > > both in terms of content and organization of writers. That said, I'm > > quite happy for you to use this list for general discussion of writing > > developer docs, proofreading, help with DocBook, etc. I imagine everyone > > else would feel the same, but best to check first. > > I think the fact discussion of developer documentation has historically > been kept separate is simply because there hasn't been anyone actually > discussing it.
There are two types of developer docs: API docs and "other" documentation (tutorials, introductions, in-depth discussions of spcific topics etc.) The API docs more or less has to be written by the developer. The other type of docs could very well be written by a programming-interested documentation writer in cooperation with the developer I think. Bye Alex -- Work: alexander.neundorf at jenoptik.com - http://www.jenoptik-los.de Home: neundorf at kde.org - http://www.kde.org alex at neundorf.net - http://www.neundorf.net
