RE: Minivend Documentation

["Thompson-Jordan" <Thompson-Jordan@mindspring.com>]

******    message to minivend-users from "Thompson-Jordan" <Thompson-Jordan@mindspring.com>     ******

Thanks for the intro Mike.

There are already some volunteers, so I am not to only crazy one :-) It
sounds like Mike is going to set up a separate mail list for the
documentation project so we won't clutter this one with messages.

To pick up where Mike left off, I think first we need to evaluate the
current documentation to find out things like:
- in what form people are using it (e.g. one big HTML file, printed, local,
online),
- which parts work, and which parts don't,
- how it's generated

I think making a German version part of the process (both for the initial
revision and updates) seems obvious (other languages as well). Once that
input is in, we can start thinking about process, tools, structure, etc.
etc. etc. etc. Mike has already given me many good ideas.

Feel free to email me directly, although I prefer that discussion take place
in the mail list - in keeping with the open source spirit.

Christopher Thompson


> -----Original Message-----
> From: owner-minivend-users@minivend.com
> [mailto:owner-minivend-users@minivend.com]On Behalf Of
> mikeh@minivend.com
> Sent: Friday, February 19, 1999 10:34 AM
> To: MiniVend User List
> Subject: Minivend Documentation
>
>
> ******    message to minivend-users from mikeh@minivend.com     ******
>
> Dear All,
>
> I would like to announce a documentation project for MiniVend.
>
> The initial goals, which will be evaluated after all of your input,
> are:
>
>     1. Production of a user's manual based on the latest simple demo.
>     2. Production of an installation HOWTO.
>     3. Clean up of the current reference to make terms more consistent,
>     remove inconsistencies, document missing tags, etc.
>
> Christopher Thompson <Thompson-Jordan@mindspring.com> has agreed to lead
> the project. I will of course participate, though not so closely so the
> result ends being the same as the current document. 8-)
>
> We are looking for:
>
>     - Volunteers to help with writing
>     - Input on ideas, likes, dislikes, needs, etc.
>
> First, we need to find out how people are using the current documentation,
> what parts they use and which parts they don't, in what format, and why.
> Once that input is in, we can start.
>
> --
> Mike Heins                          http://www.minivend.com/  ___
>                                     Internet Robotics        |_ _|____
> Few blame themselves until they     131 Willow Lane, Floor 2  | ||  _ \
> have exhausted all other            Oxford, OH  45056         | || |_) |
> possibilities.                      <mikeh@minivend.com>     |___|  _ <
>  -- anonymous                       513.523.7621 FAX 7501        |_| \_\
> -
> 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