R: [ic] Re: [mv] documentation

Rick Walker rich@ednet.co.uk
Fri, 22 Sep 2000 13:26:10 +0100 (BST)


Please.........

On Fri, 22 Sep 2000, Valerio Santinelli wrote:

> I completely agree with you. A sort of "tutorial" on how to build the main
> pages would be wonderful.
> 
> Valerio Santinelli
> Register.it Support Team
> 
> ------------------------------------------------------------
>  http://www.register.it/
>  mailto:support@register.it
> 
>  Register.it by GOT.IT srl - Italy
> ------------------------------------------------------------
> 
> 
> 
> > -----Messaggio originale-----
> > Da: interchange-users-admin@minivend.com
> > [mailto:interchange-users-admin@minivend.com]Per conto di draftd
> > Inviato: venerd́ 22 settembre 2000 14.18
> > A: interchange-users@minivend.com
> > Oggetto: [ic] Re: [mv] documentation
> >
> >
> > Hello,
> > After reading most of the documentation I could find about interchange, I
> > would like to give a few personal remarks. Not that I want to
> > hurt people by
> > commenting on their work, but because they really asked for
> > comments on the
> > documentation.
> >
> > What I think is needed most for new users is just a very basic "quick
> > interchange introduction".  so for example:
> > -a brief explanation of the fact that interchange relies on a server that
> > creates html-pages on-the-fly.
> > -You can adjust this page-creation and all kinds of database-operations by
> > the interchange-tags, but they aren't in the actual html-pages. They're
> > needed to build the pages.
> > -interchange uses a cgi-script that points to the pages. So their
> > aren't any
> > pages in the cgi-bin, pages are in /pages/
> > -and most importent: a detailed description of the code of a few
> > pages: eg.
> > the index.html, lefside, and a few other. Of course not all of
> > the pages. I
> > think it will help new users more to look at a few pages, their
> > code and the
> > explanation of what's happening than reading throughout the whole
> > all-covering tag reference: what does the ui_template there, this
> > [area] tag
> > is used here for...., this is an image from the /thums/ dir etc.
> > -.....
> >
> >
> > I know all these things are fully covered in the reference guide,
> > but if you
> > don't know any of the above, it's hard to distinguish between important
> > things and "nice add-ons".
> > Am I right or just writing a lot of qlksjfghfhgq ?
> >
> > kind regards,
> > Tom
> >
> > ----- Original Message -----
> > From: Greg (Sonny) Cook <sonny@akopia.com>
> > To: <minivend-users@minivend.com>
> > Sent: Monday, August 07, 2000 9:30 PM
> > 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
> >
> >
> > _______________________________________________
> > Interchange-users mailing list
> > Interchange-users@www.minivend.com
> > http://www.minivend.com/mailman/listinfo/interchange-users
> >
> 
> 
> 
> _______________________________________________
> Interchange-users mailing list
> Interchange-users@www.minivend.com
> http://www.minivend.com/mailman/listinfo/interchange-users
> 

-- 
Rick Walker
edNET
0131 538 7198