RE: [mv] minivend--interchange documentation

["Christopher Thompson" <ct@arborinternet.com>]

******    message to minivend-users from "Christopher Thompson" <ct@arborinternet.com>     ******

I just thought I would try to respond before Birgitt ;-)

I think the three areas where the current docs need to be improved are:

- organization of the main doc index and multiple organizations for the
reference docs (e.g. alphabetical, grouped by related tags, functional
grouping)

- completeness of the tag documentation so that every tag is covered and
each is completly documented

- the ability for users to add annotations to the online documentation.

I think the PHP documentation is a good example of simple, usable docs.


> -----Original Message-----
> From: owner-minivend-users@minivend.com
> [mailto:owner-minivend-users@minivend.com]On Behalf Of Greg (Sonny) Cook
> Sent: Monday, August 07, 2000 12:31 PM
> To: minivend-users@minivend.com
> Subject: [mv] minivend--interchange documentation
>
>
> ******    message to minivend-users from "Greg (Sonny) Cook"
> <sonny@akopia.com>     ******
>
>
> Hi all,
> By way of introduction, I am one of the developers at Akopia.  I have
> taken on (bravely IMHO) the task of documentation organization for our
> next release of intervend.  Even though I am personally opposed to
> documentation, I have a grand vision for a complete set of documents of
> the project.  Kind of everything from "What's a computer?" to "minichange
> hacker" level.  There is of course an already extant and rather copious
> corpus avaliable from Mike.  I've noticed it's still pretty hard to get
> going though.  At any rate, rather than share my concerns with the present
> state of the documentation, I'd like to determine what sort of
> documentation people would like to see.  Also what do you think we could
> do to the current documentation to improve it.  If you're feeling really
> ambitious, you could even write all of the documentation I want for me
> :-}.
>
> Currently I am combing through the mailing list archives, trying to rescue
> usefull information from the past.
>
> Thanks,
> Sonny Cook
>
>
> -
> 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