|
(First: thanks to all you devs, because I've just come back from Palermo where I tested live my system: it was a big big fun, and max/msp people at the 2-days course were impressed by sc...) 1. I've used the helper classes for GeoGraphy and seems to work really fine, hugely increasing the documentation task's speed, apart form a strange question of pale colors, which has been already noted by Thor.... I'll surely take a look into this (ans ask you, Scott, if I still can't understand what's going on), and into the classes more in general. Here I'm speaking of those classes working in this way: Help.makeHelp(AClass) 2. For what is concerning autogenerating docs from comments in sources (the other idea we discussed), the class I posted was just a test to show a possible mechanism. It actually does not work into the real world. More, first a strong agreement on how to mark up sources would be needed. This would not be bad in a more general sense as there's a wide variety of way of commenting sources, as far as I can tell. But maybe this is simply not a problem at all. So: 1. I'll revise the helper classes. 2. I would suspend the autodocumentation from source mechanism because it needs a more consistent approach What's the deadline for 3.2? Best -a- PS: should not be useful to have e.g. a wiki page (could be Jan's, I guess) where to keep track of thing to be, requests, etc? On 20 Dec 2007, at 22:41, Scott Wilson wrote:
-------------------------------------------------- Andrea Valle -------------------------------------------------- CIRMA - DAMS Università degli Studi di Torino -------------------------------------------------- I did this interview where I just mentioned that I read Foucault. Who doesn't in university, right? I was in this strip club giving this guy a lap dance and all he wanted to do was to discuss Foucault with me. Well, I can stand naked and do my little dance, or I can discuss Foucault, but not at the same time; too much information. (Annabel Chong) |