cocoon-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Conal Tuohy" <>
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?


> -----Original Message-----
> From: David Crossley []
> Sent: Thursday, 11 July 2002 17:45
> To:
> 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

View raw message