Received: (qmail 44062 invoked by uid 501); 3 Jun 2001 19:48:11 -0000
Message-Id: <20010603194811.44061.qmail@apache.org>
Date: 3 Jun 2001 19:48:11 -0000
From: Eli Dart <eddart@home.com>
Reply-To: eddart@home.com
To: submit@bugz.apache.org
Subject: searching documentation for version 1.3 gives info for version 2.0
X-Send-Pr-Version: 3.110

>Number:         7814
>Category:       documentation
>Synopsis:       searching documentation for version 1.3 gives info for version 2.0
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    apache
>State:          open
>Quarter:
>Keywords:
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   apache
>Arrival-Date:   Sun Jun 03 12:50:00 PDT 2001
>Closed-Date:
>Last-Modified:
>Originator:     eddart@home.com
>Release:        1.3 2.0
>Organization:
apache
>Environment:
This has to do with the public docs web site for apache.
>Description:
I was having trouble configuring server-side includes, so I searched the docs.
I searched the Apache 1.3 docs, and came up with some pages.  I started reading
them, and found things that didn't make sense.  It turned out that I was being
given docs for version 2.0 when I had searched the version 1.3 documentation.

Looking again, I notice from the URLs that numerous hits for version 2.0 docs
were returned by the search.

This isn't so bad under normal circumstances, but when there is a fire to put
out it can be problematic....
>How-To-Repeat:
Go to:  http://httpd.apache.org/docs/  Note that the page says "Apache HTTP
Server Version 1.3"

enter the search string "server side includes" and search

Notice that several of the top search results contain version 2.0 documentation.
>Fix:
segregate the docs for version 1.3 and version 2.0
>Release-Note:
>Audit-Trail:
>Unformatted:
 [In order for any reply to be added to the PR database, you need]
 [to include <apbugs@Apache.Org> in the Cc line and make sure the]
 [subject line starts with the report component and number, with ]
 [or without any 'Re:' prefixes (such as "general/1098:" or      ]
 ["Re: general/1098:").  If the subject doesn't match this       ]
 [pattern, your message will be misfiled and ignored.  The       ]
 ["apbugs" address is not added to the Cc line of messages from  ]
 [the database automatically because of the potential for mail   ]
 [loops.  If you do not include this Cc, your reply may be ig-   ]
 [nored unless you are responding to an explicit request from a  ]
 [developer.  Reply only with text; DO NOT SEND ATTACHMENTS!     ]