Re: [Mod-auth-devel] new documentation started

[Paul Q. <ch...@fo...>]

> > In the next few days I will move this to an automated cronjob.
> >
> > I think making web based docs better is more important than a very heavy
> > README. (as ours is becoming)
> 
> well, at least for compiling, i like to have docs around
> that i can read without a webbroswer.
> 
> the other documentation can go into the website.

Yes, i think the README/INSTALL Files should include the basic docs to get
started, but i felt the Readme was starting to turn into a full out guide on
authn_dbi.  Keeping the Readme short and sweet on howto install and get a very
_basic_ setup is all that is needed.  I think that it should tell people where
to find indepth documentation (on the website)

> 
> what are your plans for mod_authn_mysql/mod_authn_pgsql?
> do you want to keep them parallel to mod_authn_dbi to have
> a way to authenticate against them witout having to use
> libdbi or to use special features of the db or will
> you phase these modules out?

Once authn_dbi is stable, I plan to take it and port it to raw pgsql and
mysql.  I had always intended to keep authn_mysql upgdated, but as i worked on
authn_dbi, it fell behind(and now it is horribly outdated)

> i saw that you marked a few of the configuration directives
> as depreciated. do you plan to remove them?
> at least AuthnDbiPasswordField would have to stay for the moment,
> it is not only used in populate_querystring but also to
> pick the password field from the result of the SQL query.
> 
> and i would like to keep the other directives as well. they are a
> nice lightweight way to configure it without having to fiddle
> with the query.

Hmm. I am not sure how i want to go on with this.  I like the Query system
better, but having the directives for each field is a nice way to get a simple
query setup.  Maybe we should keep them in?  I just marked them depreciated
because I would like to move to just having a query config, but i really
didn't think about it alot.  Now that I am thinking about it, I am not sure
which way I want to go.

> 
> what will happen to the mod_authn_dbi site at cyanworlds?

Once we are ready for the first release, and a basic "homepage" is done, I
will get the links changed.
 
> when we have the first realease out, we should probably change
> the entry in the module-registry to point to the new site too..

dito here.

-chip