[Zope3-dev] proposal to extend meta.zcml files with documentation strings

[Jeremy Hylton]

>>>>> "SH" == Shane Hathaway <shane@zope.com> writes:

  SH> The main trouble I've had with ZCML is that it's hard to find
  SH> the Python code it supposedly invokes.

I agree!  I once tried to deduce the relationship between a ZCML
directive and the code that handled it by reading the configuration
code ;-).

  SH> My proposed solution to this is to use objects, not tuples.  A
  SH> directive should be represented as an object.  A configuration
  SH> file should be an object.  An active configuration should be an
  SH> object.  I think it could lift a lot of the complexity of Zope 3
  SH> configuration.  I've been drafting rough interfaces, if anyone
  SH> is interested.

This sounds like a good idea, although I'm probably not the best
person to judge.  If it makes the relationship between the
configuration file and the code it invokes clearer, I'm in favor.

Jeremy