apr-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Davi Arnaut <d...@haxent.com.br>
Subject Re: Documentation Project
Date Mon, 24 Apr 2006 20:54:06 GMT
On Mon, 24 Apr 2006 16:13:38 -0400
Tom Bradford <bradford653@gmail.com> wrote:

> On Apr 24, 2006, at 3:54 PM, Davi Arnaut wrote:
> >> 2) I notice that there is a database interface, but even though
> >> SQLite is supported, the exposed APIs resemble DBM-style interfaces.
> >> Is there a plan to create a super-simple rowset style interface for
> >> backends that support it?
> >
> > I don't know, what does Google say ?
> 
> Well, I was hoping that an actual representative of the project could  
> speak to what is planned for the project proper, rather than try to  
> infer what may or may not be happening to the project at some point  
> in the future.
> 
> >> 3) The documentation is scarce or non-existent.  Everything I've
> >> learned thus far has been from Inoue Seiichiro's tutorial.  Are there
> >> any official documentation project's active or planned?
> >
> > http://apr.apache.org/docs/apr/modules.html
> > http://apr.apache.org/apr2_0intro/apr2_0intro.htm
> 
> Sorry, but Doxygen and a slideshow with little to no actual  
> information (both of which I've already seen) do not a suite of  
> documentation make.  Doxygen is as valuable in the grand scheme of  
> things as is Javadoc, and that's not much because neither are able to  
> paint an overall picture of contextual or global cohesion.  As I was  
> saying, Inoue Seiichiro's tutorial is by the far the best  
> documentation I've found for APR, and the fact that nothing made  
> available by the APR project itself even comes close is somewhat  
> disconcerting.

IMHO, Inoue Seiichiro's tutorial goes out of scope (eg, describing what
a thread is, et cetera). What kind of documentation you're most interested
in ? Guides, how-to, tutorial..

> Let me reiterate.  I' very impressed with the API, and I see broad  
> developmental usage for APR outside of the Apache project proper, but  
> the major hurdle at this point is the very real lack of  
> documentation.  Not need to get defensive about it, especially since  
> I'm offering my assistance.
> 

Fair enough. Welcome aboard.

--
Davi Arnaut

Mime
View raw message