Mailing-List: contact apache-docs-help@apache.org; run by ezmlm
Precedence: bulk
Reply-To: apache-docs@apache.org
From: "Joshua Slive" <joshua@slive.ca>
To: "Craig Arno" <craig@arno.com>
Cc: <apache-docs@apache.org>
Subject: RE: config/8492: IP based Virtual Host firewall implementation must
 use ifconfig IP, not DNS IP
Date: Wed, 10 Oct 2001 16:57:04 -0400
Message-ID: <ELEDJONBOPPAEGANDEEIAEDKCAAA.joshua@slive.ca>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: 7bit
In-Reply-To: <Pine.LNX.4.33.0110101320360.21794-100000@arno.com>
Importance: Normal

Thanks for the detailed response.  I am forwarding your critique to the
apache-docs@apache.org list where we discuss documentation improvements.

Thanks again.

Joshua.

> -----Original Message-----
> From: Craig Arno [mailto:craig@arno.com]
>
> Joshua is correct, I was looking in the wrong file.  I tried to understand
> why?
>
> I went back with Joshua's information to gain an understanding of how I
> could be so wrong headed.  (Normally, I'm not).  I ended up with this
> page:
>
> http://httpd.apache.org/docs/vhosts/name-based.html
>
> Given all my confusion with a large set of terminology new to me, and a
> large body of documentation, it would help if the first heading
> "Name-based vs. IP-based virtual hosts" section started with a very simple
> explanation of the form;
>
> "Name-based virtual hosts are machines with multiple names associated with
> any one particular network adapter/IP interface.  i.e.
> [192.168.1.1-www.myDomain1.com,www.myDomain2.org,www.myDomain3.com],
> [192.168.1.2-www.myDomain4.net,www.mydomain5.com]
>
> "IP-based virtual hosts will associate only one domain with one or more
> network adapters/IP's in the host computer." i.e.
> [192.168.1.1-www.myDomain1.com], [192.168.1.2-www.myDomain2.com],
> [192.168.1.3-www.myDomain3.net], etc.
>
> The writing rule I would apply is get directly and clearly to the point.
> Save additional point development and history discussion for following
> paragraphs.  The first sentence and paragraph should help the user decide
> they found the needed section and should keep reading.  I enjoy reading
> all the supporting history and thought after I am convinced I found what I
> need.
>
> Your users, if they are anything like me, are installing and maintaining
> many different applications.  Each application contains large amounts of
> documentation where the user must determine the logical layout and new
> terminology used and navigate quickly to an answer to a question.
>
> This confusion is compounded when these users must update all their
> applications as time permits to prevent the latest internet security
> breaches.
>
> Now, if you've read this far, I'd like to thank Joshua for being patient,
> kind and helpful while I clubbed my way through this process.
>
> Craig Arno
>
> [My problem is closed now too!]
>
>
> On 10 Oct 2001 slive@apache.org wrote:
>
> > [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!     ]
> >
> >
> > Synopsis: IP based Virtual Host firewall implementation must
> use ifconfig IP, not DNS IP
> >
> > State-Changed-From-To: feedback-closed
> > State-Changed-By: slive
> > State-Changed-When: Wed Oct 10 11:39:53 PDT 2001
> > State-Changed-Why:
> >
> > User was looking in the wrong documentation file.
> >
> >
>
>


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