On Thursday 31 July 2008 20:33:19, Stefan de Konink wrote:
> > > * <8> Table with equivalent functionality (and hopefully a full
> > > setup example) to that of specific  mod_* Apache modules.
> >
> > I don't think this is really interesting. Besides the support of the
> > Apache de-facto standards we have nothing to do with it.
>
> Although some cherokee handlers (for example mine) are more like small
> applications  (vs scripts in python/php) it might still be interesting to
> show what we can do with Cherokee on a higher level and how easy it is to
> do so.

I must admit I didn't think about these specific cases. What I actually meant 
with <8> proposal was that we should have some sort of quick reference to 
specifica tasks to allow easier navigation through the documentation. Something 
in the line of "I want to use mod_rewrite, how do I do this with Cherokee", 
which should explain briefly how to rewrite URLs and what module's docs should 
be consulted to have more specific details.

In my flawed reasoning, I assumed everyone knew what every Apache module did, 
so I suggested the name of the module as index of our quickref table.
But I guess it is much more logical to simply state the desired task to 
achieve, and then write the small sections I was thinking of.

I do think Stefan is right about the benchmarking thing, but I would rather 
leave that part for the website and out of the documentation. Mostly for 
maintenance reasons: updating this kind of comparisons takes time, and though 
we're talking about a complete rework of the documentation this should be a one 
time thing.
Hopefully in future releases the documentation will grow incrementally but 
without requiring a complete rewrite for every release.
-- 
[EMAIL PROTECTED]
http://unixwars.com
_______________________________________________
Cherokee mailing list
[email protected]
http://lists.octality.com/listinfo/cherokee

Reply via email to