Re: [mv] IF tag: [if session login] doesn't work?

[Birgitt Funk <birgitt@booktraders.com>]

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



On Thu, 23 Mar 2000, Mike Heins wrote:

> ******    message to minivend-users from Mike Heins <mikeh@minivend.com>     ******
> 
> Quoting David Gindelberger (davidgindelberger@yahoo.com):
> > 

[snip]

> 
> My problems with most of the people complaining about the documentation:
> 
>     1. Often there are complaints made without specific examples.
>     2. Rarely do I get specific suggested fixes.
> 

[snip]

> In other words, I believe your documentation of my problems with
> documentation is simply awful. 8-) 

8-) I love that answer...

> Of course there are exceptions; see the outstanding job someone (Bill
> Randle) did the other day helping me document the error tag.

May be it is just very simple... there are not that many who can do a job
like Bill Randle did the other day... Couldn't it be that you just over-
estimate the capabilities of many of your MV users ?

> 
> If each user subscribing to the minivend-users mail list sent one example
> with edited replacement text I would have 897 changes to make that would
> improve the documentation. That would be a fair start.
> 

...fair yes, improving the documentation ...? I would doubt it.
Wouldn't you need to be careful with what you wish for ? Just imagine
editing 897 "edited" replacement texts ... And then reading 897 authors in
one "book" would  taste like a soup prepared by 897 cooks. Better not
challenge your stomach with that... 8-)

> Also, I am still looking for someone to send me an example of good
> documentation for *a program with similar scope and a similar target
> audience*. 

None there. Expecially not the same target audience. Just look who is
answering right now...

> Someone suggested the PHP documentation, and it seems quite
> good, but the target audience is quite different.
> 
> To summarize:
> 
> 	-- I am interested in making the docs better
> 	-- I am working on it
> 	-- I do need help

Somehow it's a bit sad to see you still taking the documentation
complaints too much to heart. The documentation is fine for people who
know what they are doing. For the people who only know what they want to
do, but not yet how to do it, MiniVend's documentation will always be a
challenge. That's normal. It's for the most part not related to the way
the documentation is written (aside from things which simply are not
documented at all). I would not worry about it.

Birgitt
        
> 
> Best Regards,
> Mike
> 
> -- 
> Internet Robotics, 131 Willow Lane, Floor 2, Oxford, OH  45056
> phone +1.513.523.7621 fax 7501 <mikeh@minivend.com>
> 
> Friends don't let friends use Outlook. -- Bob Blaylock
> -
> 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
> 

-
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