On Tue, 12 Jan 2010 09:25:05 +0100 Markus Armbruster <arm...@redhat.com> wrote:
> > We were considering something along these lines > > but we didn't consider having the description as part of the dict, > > for example. > > We did, actually :) That's good then! > > This solves some issues we were trying to address. > > > > The only problem I can see is that the documentation and code will > > be in different places, which makes it easier to get outdated. > > Not necessarily. Documentation will be in whatever place we put it. > Some places require tools to extract it. I was thinking in having them on separate file just to make the work as easy as possible, having a tool to extract them from the function's documentation is perfect, but I'm afraid you'll have to come up with your own tags to distinguish among responses, events, commands etc.
