i.galic at brainsware
Apr 10, 2012, 6:29 AM
Post #5 of 5
----- Original Message -----
Re: A review of SSL docs WAS Re: A proposal from Symantec for cleaning up the SSL-related documentation for Apache's HTTPD
[In reply to]
> On Apr 4, 2012, at 7:42 PM, Mads Toftum wrote:
> I think some of the assertions come from people who don't
> appreciate his style of writing - much of his original mod_rewrite
> documentation got butchered on a similar background.
> Yep. Our users are just begging for the good old days when the
> documentation started with a warning that they were about to be
> dreadfully confused, and then proceeded to call them silly for
> wanting it to do useful things. Ah, nostalgia.
Judging from the feedback on on Sander's poll, as well as
from recent experience on #httpd, people expect our docs to
be so bad or useless that they don't even bother looking,
and just ask for a howto.
Now, I'm not a big fan of howtos, or rather, for what generally
passes as howtos. But it would be really nice if our docs
covered the basic use-cases.
Much of that is already happening. One of the things were
I see room for improvement is
The separation of topics is good, but they are sorted
alphabetically, which is not very useful.
A glaringly obvious gap is a soft-intro.
*) I'm an aspiring systems administrator, I've never run
a web server. Where do I start?
*) I know what a web server is, but I've never touched
Apache httpd, how do I get started?
*) I'm a PHP/Perl/Ruby/Python hacker. What do I need to
do to setup an environment like my admins will be running
oh, and maybe, fitting to the subject line:
*) How do I actually secure my site with HTTPS?
> Rich Bowen
> rbowen [at] rcbowen :: @rbowen
> rbowen [at] apache
That's all folks o/~
Tel: +43 (0) 664 886 22 883
Mail: i.galic [at] brainsware
GPG: 6880 4155 74BD FD7C B515 2EA5 4B1D 9E08 A097 C9AE
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd