On Thu, 16 Feb 2006 08:15:17 +0100
Gert Ingold <[EMAIL PROTECTED]> wrote:

> Dear Simon,
> 
> > B) how to plot diamonds should not be in the FAQ, it's either in
> > the examples or in a cookbook. The FAQ (or at least the graph section)
> > is not an FAQ at all, it's a cookbook.
> 
> as the person managing the FAQ, I am of course very much interested in your
> ideas concerning the FAQ. Does your objection mainly concern the name of
> the FAQ, i.e. do you feel that it does not appear natural to look there for
> certain problems even though the answer can be found there? 

Yes, that's correct.

...
> Basically, I think that a cookbook, i.e. a sort of merger of the present
> FAQ and the examples, would probably be most helpful for many users. The 
> problem is that to do a good job, one needs a fairly good understanding of 
> the examples and on the other hand some time to work on explanations. But 
> this is certainly something which needs to be pursued and as far as I 
> understand, some preliminary work has been done already (Andre knows more 
> about this).
> 

Would a wiki approach work for this ?

I don't think explanations are that important; once the user sees a use case
they will know what the type-signature is and be able to experiment from there.

Simon.


-- 
Simon Burton, B.Sc.
Licensed PO Box 8066
ANU Canberra 2601
Australia
Ph. 61 02 6249 6940
http://arrowtheory.com 


-------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc. Do you grep through log files
for problems?  Stop!  Download the new AJAX search engine that makes
searching your log files as easy as surfing the  web.  DOWNLOAD SPLUNK!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=103432&bid=230486&dat=121642
_______________________________________________
PyX-user mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/pyx-user

Reply via email to