6 messages in ru.sysoev.nginxRe: nginx documentation
FromSent OnAttachments
Gregg ReynoldsMar 4, 2007 3:53 pm 
Jonathan VanascoMar 4, 2007 5:17 pm 
Dimitri AivaliotisMar 6, 2007 6:14 am 
Igor SysoevMar 6, 2007 10:29 am 
Igor SysoevMar 6, 2007 10:33 am 
Aleksandar LazicMar 7, 2007 12:46 pm 
Actions with this message:
Paste this link in email or IM:
Paste this link in email or IM:
Atom feed for this thread
Paste this URL into your reader:
Subject:Re: nginx documentationActions...
From:Igor Sysoev (is-G@public.gmane.org)
Date:Mar 6, 2007 10:29:46 am
List:ru.sysoev.nginx

On Sun, Mar 04, 2007 at 08:17:27PM -0500, Jonathan Vanasco wrote:

On Mar 4, 2007, at 6:53 PM, Gregg Reynolds wrote:

it's developer-oriented. Ordinary _users_ of the software don't care about modules; for them it's better to organized things by functional category (or more generally, according to the mental model the user is likely to have of how a web server functions).

I'd disagree with that.

Looking at the documentation for other webservers, such as apache , everything is presented in terms of modules.

It might make sense to have an overview or tutorial as a general nginx man page, describing what features are in each of the core distribution modules , but many of the nginx commands exist only if specific modules were compiled into the system or not. I fear a functional-oriented approach would require many unnecessary modules to be compiled in by default, and be rather misleading due to the modular design of nginx.

At least that's my view.

I think that the functional-oriented view point documentation is good. I see it as an end user of mutt, exim, postfix, etc.