httpd-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Niklas Edmundsson <ni...@acc.umu.se>
Subject Re: 3.0 - Proposed Goals
Date Wed, 14 Feb 2007 14:41:38 GMT
On Wed, 14 Feb 2007, Garrett Rooney wrote:

>> - Rewrite how Brigades, Buckets and filters work.  Possibly replace them
>> with other models. I haven't been able to personally consolidate my
>> thoughts on how to 'fix' filters, but I am sure we can plenty of long
>> threads about it :-)
>
> I think a big part of this should be documenting how filters are
> supposed to interact with the rest of the system.  Right now it seems
> to be very much a "well, I looked at this other module and did what it
> did", and it's quite easy to start depending on behavior in the system
> that isn't actually documented to work that way.

This hits a rather sweet spot it seems. Browsing the current httpd 
module/developer docco I find gems like:
http://httpd.apache.org/docs/2.2/developer/modules.html

One would think that now that 2.2 is released at least the 1.3->2.0 
converting docco would have evolved to something better than "it's a 
start" ...

Also, we have http://httpd.apache.org/docs/2.2/developer/API.html ... 
It seems that the most current API docco is for 1.3, but at least 
there's a nice disclaimer telling that it's obsolete but some 
information might be correct.

So yes, I fully agree that documentation is needed. It's a pain trying 
to figure out how stuff (are supposed to) work when the docco is two 
major releases behind...

One problem here is that this kind of docco usually needs to be made 
by those who hate to write it: the core programmers.


/Nikke
-- 
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  Niklas Edmundsson, Admin @ {acc,hpc2n}.umu.se      |     nikke@acc.umu.se
---------------------------------------------------------------------------
  "I should have done this a long time ago." - Picard
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Mime
View raw message