[Opensource] Expresso 4.1 Documentation/Release

[Michael Rimov]

At 12:03 PM 8/20/2002 +0200, you wrote:
>Hi all,
>
>I was just wondering if there's anybody out there working on updating the
>developer documentation as the product nears release date? Or is anything
>planned in this respect? Obviously, there have been many improvements on the
>way things work and are supposed to be implemented. I don't have enough
>experience to contribute much in this area at this point. On the other hand,
>the lack of experience is largely due to a steep learning curve due to the
>lack of documentation. Boring as it may be, the documentation process is
>probably at least as important as the development process. Sorry if that
>sounds a little moralistic. It's not intended as such. I do intend to
>contribute in this area once I'm up to speed with the package.
>
>Kind regards,
>
>Marc Schipperheyn
><theFactor.e>

Hi Marc,

Actually the problem isn't so much as intent as time.  I've been flat 
booked with 7(!!) projects on my plate that I'm switching between.  So I 
update EDG when I have a moment, but it's hardly adequate.

I DID update Chapter 5 in EDG to remove some of the outdated information on 
DBObjects, (For example, "auto-inc" vs. the old NextNumber)  And Larry H 
and I have updated Chapter 10 on security.  But that's as far as I've been 
able to accomplish.  Once 4.1 final is out the door I'm planning a 'getting 
the most out of Expresso 4.1' article that should help people getting up to 
speed.

So that's the status of the docs right now for better or for worse :)..  If 
somebody wants to tackle portions of the EDG, that would be great for 
me.  It is in DOCBOOK format which isn't too bad to write in although the 
DTD looks mind numbing, it's actually not too bad if you just keep in the 
basic tags... <sec1> <para> <programlisting>  etc.....

                                                 -MIke