cocoon-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Conal Tuohy" <con...@paradise.net.nz>
Subject RE: Cocoon docs link check
Date Thu, 11 Jul 2002 05:54:52 GMT
Hi David

When you say "more automation is needed" and "does anyone have a clever
solution", what kind of thing did you have in mind? i.e. What in your
opinion is deficient about the link-checking tools that are currently used?

Con

> -----Original Message-----
> From: David Crossley [mailto:crossley@indexgeo.com.au]
> Sent: Thursday, 11 July 2002 17:45
> To: cocoon-docs@xml.apache.org
> Subject: Re: Cocoon docs link check
>
>
> Bert Van Kets wrote:
> > In the current light of link checking I did a full test of
> the CVS HEAD
> > using XENU.
> > The report is included.  There are still some errors to be
> fixed.  Since
> > some of these point to obsolete pages, I'm not sure they should be
> > removed.  Therefor a patch is a bit difficult.
> > Diana, do you check this out?
> > Bert
>
> Anyone who feels similar itches can assist. It is one of mine,
> so i have helped out in the past. More assistance is needed
> and more automation is needed.
>
> Cocoon has various tools to ensure the internal links, so we
> are quite safe there. That is as long as people do "build docs"
> before creating or committing a patch. The build will fail on
> internal breaks. (Not sure about links to and within Javadocs.)
>
> Cocoon also provides its webapp/samples/linkstatus/ that does
> internal link checking. That is very useful. For HEAD, it is
> currently showing a few minor breaks.
>
> External links are a bit trickier. It is not really fair to
> banish them just because they were not accessible on the day
> that the link verification was run. I have been maintaining
> a document in CVS that summarises the LinkAlarm run and
> records how often they have been down from run-to-run.
> Obviously that is not an ongoing solution.
>
> Actually the external link situation is going to become an
> issue, now that we have accepted a whole section of Cocoon
> docs devoted to external resources at links/
>
> Robust internal links is the main issue. However, how far
> do we go down the road of external link management? Does
> anyone have a clever solution?
>
> I just added a new document to CVS to explain the various
> tools and how people can help.
> --David
>
>
>


Mime
View raw message