httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Noirin Plunkett <noi...@apache.org>
Subject Re: [PATCH] mod/mod_usertrack.xml
Date Tue, 13 Jun 2006 09:19:34 GMT
On Mon, Jun 12, 2006 at 06:19:01PM -0700, Matt Lewandowsky wrote:
> I was reviewing the mod_usertrack docs and a few things jumped out at 
> me as "this should be corrected". So, I took it upon myself to do so 
> and the patch is attached.

First off, thanks a mill for this! =)

> Changes:
> 
> Index: mod_usertrack.xml
> ===================================================================
> @@ -123,6 +123,16 @@
> +
> +    <note>
> +            <p>Most browsers in use today will disallow cookies to be set for
> +            a "two-part top level domain" such as <strong>.co.uk</strong>.
This

I'd prefer "will not allow cookies to be set", rather than "will
disallow" -  if you want to keep disallow, you'll have to change the
wording a little - "will disallow cookies from being [...]"

> +            is because a two-part top level domain is equivalent to a top level
> +            domain such as <strong>.com</strong>. Allowing such cookies
may be

I had to read this several times before I understood what it meant. It's
definitely a useful piece of info to have in the docs, but perhaps we
could rephrase it a bit. My patch is attached, let me know if it's any
clearer, or if I've just been staring at this so long that I get it now =)

> +    users' browsers. As of mid-2006, most browsers only fully support
> +    <code>CookieStyle Netscape</code>.</p>

I've also changed this to "At the time of writing" - if these docs don't
get updated for another seven or eight years, at least then the reader
has to dig back to see how old and crufty they are, rather than having
it printed there before them =)

Noirin


Mime
View raw message