httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject [Bug 57584] AddHandler etc. documentation "extension" unintuitive
Date Mon, 20 Apr 2015 17:03:13 GMT
https://bz.apache.org/bugzilla/show_bug.cgi?id=57584

--- Comment #12 from Chris Pennello <apache@chrispennello.com> ---
(In reply to sebastian from comment #11)
> Chris, where are you? :)
Hello.  :]

> (In reply to Rich Bowen from comment #10)
> > Thanks. Closing.
> 
> I'm actually not sure if the core of this bug is fixed yet.
> The core as shown by the title is that the documentation on "extensions"
> could be considered unintuitive to larger groups of the user base.
> Looking at <https://httpd.apache.org/docs/current/mod/directive-dict.html>
> for instance, it still reads
> 
>   "extension: In general, this is the part of the filename which follows
>   the last dot. [..]"
> 
> before it goes on to (re)define what an extension is to Apache.
> With that first sentence and previous background, it would make perfect
> sense to stop reading after that first sentence.  My vote for more changes
> in that area.
I'm generally agreed.  I tried to provide two actionable recommendations given
that it doesn't sound like the behavior itself will change any time soon.  (See
the first link I mentioned in the OP.)

If we're intent on continuing to use the word "extension" in the AddHandler,
etc. documentation, then I suggest adding a note in the AddHandler, etc.
directive documentation regarding the unusual definition used in Apache, and
link to further details.  Furthermore, it might be helpful to provide an
example that doesn't lead to as many unexpected consequences when naively (as
is frequently the case) followed.

-- 
You are receiving this mail because:
You are the assignee for the bug.

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


Mime
View raw message