httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Dirk <noi...@gmx.net>
Subject Docs are demotivating, confusing, bloated and worthless
Date Wed, 06 Oct 2010 15:10:59 GMT
Compare
1) http://httpd.apache.org/docs/2.0/mod/mod_rewrite.html
with
2) http://www.workingwith.me.uk/articles/scripting/mod_rewrite (unrelated to me)



1) is demotivating, a textual desert, has no copy&paste-ready examples

2) starts with "A simple mod_rewrite example" so that you at least know what, the fuck, mod_rewrite
is about...


I can click on *any* module in the apache docs and have to crouch through a text desert to
find out what i am looking at...

Check out the php documentation on php.net... there is no substitue for it.. since it is awesome...
well.. there is w3schools
who also cover php.. but php.net docs are still superior...

then go and look for apache docs... there are millions of subsitutes that try to fix what
is wrong with your documentation...

i consider this to be a constructive critique... if you don't get it you dont get it...


Dirk

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message