Hey, On 17.02.06, Simon Burton wrote: > > 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 ?
In some sense I like the wiki approch very much in that it would allow our users to improve the situation in a way it helps *the* *users*. However, I think in the end we do not want some arbitrary list of comments. An editorial board which steamlines the descriptions would be best. For that I've started (well, several months ago) a system to provide descriptions to the examples. I would like to make the examples more cookbook-like. This doesn't really mean, that we need to change much in what the examples show, but we need to explain, what is going on. Most of the examples really have some deeper meaning, and my discussions (for example with Gert) have shown me several times, that it's very difficult for our users to look thru an example and really understand, what we want to show there. A cookbook doesn't necessarily show you everything. And it's also only a partial source for copy'n'paste code. But you can learn so much when some code really is explained. You may have a look at http://www.wobsta.de/pyxtest/examples/graphs/lissajous.html to see what I mean. And the idea is to make it easy (for us) to manage the descriptions in order we really can do some editing. (Maybe somebody even want's to join us here ... this would be great!) The descriptions are very easy to write down (in a wiki-like style). Have a look at http://cvs.sourceforge.net/viewcvs.py/pyx/pyx/examples/graphs/lissajous.txt?rev=1.1&view=markup for the source of the description of the webpage cited above. That's the direction I do have in mind. Comments are welcome. André -- by _ _ _ Dr. André Wobst / \ \ / ) [EMAIL PROTECTED], http://www.wobsta.de/ / _ \ \/\/ / PyX - High quality PostScript and PDF figures (_/ \_)_/\_/ with Python & TeX: visit http://pyx.sourceforge.net/ ------------------------------------------------------- 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
