Documentation help was [Re: [mv] mv_range_lock doesn't work in MV4!

[Birgitt Funk <birgitt@minivend.com>]

******    message to minivend-users from Birgitt Funk <birgitt@minivend.com>     ******



I just wanted to bring this thread to an end and say that I think the
whole issue of how to help the MiniVend/Minimate project documenting
itself deserves something better than helpless posts from willing
and capable people with no time. 

I am working on writing a paper with arguements supporting the
importance of advancing/extending MiniVends scope of code and its
documentation bringing the whole project into a more general context
and proposing a more general solution, may be.

When I am finished with it, I let you know the URL for you to read,
support, ignore or tear up publicly.

Birgitt

P.S.
Joachim, just some tiny remarks here in response:

On Fri, 31 Mar 2000 jojo@buchonline.net wrote:

> > Do you read the O'Reilly's English Perl books or the German ones ?
> 
> I use the O'Reilly's german "Perl Cookbook", german "Learning Perl, 2nd
> Edition" and "Advanced Perl Programming" and not the English ones! My
> stomage isn´t stronge enough to fight with perl _and_ english. But
> i´ve read a O'Reilly's english book about mailinglist server and i was
> very suprised about the fine english (easy) written text.
> 

Yup, style of English is important, even in technical docs. Audience
is worldwide. I read both versions and it is very interesting to see
that some English books are easier to understand than their German
translations and vice versa.

> 
> If you are working for a company and you have a wife and a child, you
> will not get enough time at home usually. If my child is sleeping in
> here bed and my wife is making here favorite leisure-time activities,
> i´ve time to learn more. But it is usually late or very late and the
> capability of my mental input is going down.

Everyone in the same boat here.

> Regarding the questions about the right method of reading, i believe a
> paper version of the minivend document is fine, but without no
> structure or index, you less too much times to find an usefull
> informations. The best way for me is, get an online documentation
> offline (all in one file) and use the find feature of your browser (for
> example ALT+F/ALT+G with NS in UNIX and CTRL+F or G in WIN).
> 
> 

That's what I thought. Had misunderstood your previous description of
how you work.

Birgitt

-
To unsubscribe from the list, DO NOT REPLY to this message.  Instead, send
email with 'UNSUBSCRIBE minivend-users' in the body to Majordomo@minivend.com.
Archive of past messages: http://www.minivend.com/minivend/minivend-list