Re: [PD] documentation (was: DSP abstractions)

2007-06-20 Thread Frank Barknecht
Hallo, Mathieu Bouchard hat gesagt: // Mathieu Bouchard wrote: By emphasising $1,2,3,4 it makes $5 that much more difficult and especially it makes it boring. At least if you're writing tricky documentation and you don't like writing documentation you can have a sense that you're doing

[PD] documentation (was: DSP abstractions)

2007-06-20 Thread Mathieu Bouchard
On Wed, 20 Jun 2007, Frank Barknecht wrote: You mean like http://en.wikipedia.org/wiki/Decorator_pattern ? (original page at http://www.c2.com/cgi/wiki?DecoratorPattern ) Yes, I meant it as a reference to that design pattern, but more to the problem it tries to solve Well, IMHO, a pattern is

Re: [PD] documentation (was: DSP abstractions)

2007-06-20 Thread Frank Barknecht
Hallo, Mathieu Bouchard hat gesagt: // Mathieu Bouchard wrote: But actually I'm trying to not to propose anything at all at this stage. why? Basically what I (and Roman as well, as I understand) want to achieve ATM is just a collection of documented abstractions. What to do with these

[PD] documentation (was: DSP abstractions)

2007-06-19 Thread Mathieu Bouchard
A bridge with automated service discovery could be nice, but I fear that it may also be too much bureaucracy and in the end may not help, I would especially like to say, beware of the bureaucracy and anything that looks like it. It has to do with what the values of pd are: $1 = nice