[PATCH] improved sitemap.xml

[Jeff Turner <je...@socialchange.net.au>]

Hi,

Going through sitemap.xml, I noticed a bunch of mistakes, small and large. So I
"proof-read" it, and produced the attached patch.

The patch does the following:

 - fixes the sitemap namespace URI, which was wrong. This is probably the most
   important change, since an incorrect namespace causes a really obscure error
   (http://newgate.socialchange.net.au/~jeff/misc/sitemap_error.html).
 - fixes misc grammar, rewords awkward sentences.
 - updates sitemap snippets to refer to current Cocoon packages and classes
   (eg, "org.apache.cocoon.matcher" -> "org.apache.cocoon.matching",
   "XSLTTransformer" -> "TraxTransformer").
 - clarifies certain sections, like what Selectors do.
 - changes the text of hyperlinks that implicitly assume online operation. For
   example:

 <       Detailed information on actions is <link href="actions.html">here</link>.
 --
 >       Detailed information on actions may be found in <link href="actions.html">the Actions
 >       section</link>.

   Without the blue underlining, "Detailed information on actions is here"
   implies *here*, in this document, which is incorrect, because it's actually
   *there* (actions.html).


An unaddressed issue: the second half of sitemap.xml seems pretty irrelevant to
users (a bunch of interfaces). Perhaps it should be broken off and put in a
"developers" section.

--Jeff

PS: the patch patches xdocs/sitemap.xml and documentation/xdocs/sitemap.xml.

RE: [PATCH] improved sitemap.xml

[Vadim Gritsenko <va...@verizon.net>]

Thanks, Jeff. Patch applied (with minor typo fixing ;)
And next one too.

Please check.

Vadim

> -----Original Message-----
> From: Jeff Turner [mailto:jeff@socialchange.net.au]
> Sent: Saturday, September 29, 2001 9:23 AM
> To: cocoon-dev@xml.apache.org
> Subject: [PATCH] improved sitemap.xml
> 
> 
> Hi,
> 
> Going through sitemap.xml, I noticed a bunch of mistakes, small and large. So I
> "proof-read" it, and produced the attached patch.
> 
> The patch does the following:
> 
>  - fixes the sitemap namespace URI, which was wrong. This is probably the most
>    important change, since an incorrect namespace causes a really obscure error
>    (http://newgate.socialchange.net.au/~jeff/misc/sitemap_error.html).
>  - fixes misc grammar, rewords awkward sentences.
>  - updates sitemap snippets to refer to current Cocoon packages and classes
>    (eg, "org.apache.cocoon.matcher" -> "org.apache.cocoon.matching",
>    "XSLTTransformer" -> "TraxTransformer").
>  - clarifies certain sections, like what Selectors do.
>  - changes the text of hyperlinks that implicitly assume online operation. For
>    example:
> 
>  <       Detailed information on actions is <link href="actions.html">here</link>.
>  --
>  >       Detailed information on actions may be found in <link href="actions.html">the Actions
>  >       section</link>.
> 
>    Without the blue underlining, "Detailed information on actions is here"
>    implies *here*, in this document, which is incorrect, because it's actually
>    *there* (actions.html).
> 
> 
> An unaddressed issue: the second half of sitemap.xml seems pretty irrelevant to
> users (a bunch of interfaces). Perhaps it should be broken off and put in a
> "developers" section.
> 
> --Jeff
> 
> PS: the patch patches xdocs/sitemap.xml and documentation/xdocs/sitemap.xml.
> 

---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org