Re: [mv] minivend--interchange documentation

[jojo@buchonline.net]

******    message to minivend-users from jojo@buchonline.net     ******

On  7 Aug, Greg (Sonny) Cook wrote:
> ******    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.  

Hi Greg,

my suggestion is:

- one-in-all file (HTML or text), i prefer to use such kind of doc to
  use the search functions of my browser or emacs
- Add an index page to the doc (to find the right information, if the
  docs is on the paper)
- Add more example (How to use this or that codes)

Regards,

	Joachim

-- 
Hans-Joachim Leidinger
buch online                 jojo@buchonline.net
Munscheidstr. 14            FAX: +49 209 1671449
45886 Gelsenkirchen         FAX: 0209 1671449

-
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