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:[EMAIL PROTECTED] > Sent: Thursday, 11 July 2002 17:45 > To: [EMAIL PROTECTED] > 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 > > >
