crossley 02/05/13 09:24:17
Modified: src/documentation/xdocs/plan changes-doc.xml doc.xml
Added: src/documentation/xdocs/plan linkalarm-broken.txt
linkalarm-readme.txt
Log:
Added notes about LinkAlarm scans of xml.apache.org/cocoon/ for broken links.
Revision Changes Path
1.4 +6 -1 xml-cocoon2/src/documentation/xdocs/plan/changes-doc.xml
Index: changes-doc.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/plan/changes-doc.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- changes-doc.xml 11 May 2002 07:30:06 -0000 1.3
+++ changes-doc.xml 13 May 2002 16:24:17 -0000 1.4
@@ -4,7 +4,7 @@
<!--
History of Cocoon Documentation changes
- $Id: changes-doc.xml,v 1.3 2002/05/11 07:30:06 crossley Exp $
+ $Id: changes-doc.xml,v 1.4 2002/05/13 16:24:17 crossley Exp $
-->
<changes title="Documentation History of Changes">
@@ -16,6 +16,11 @@
</devs>
<release version="@version@" date="@date@">
+
+ <action dev="DC" type="update">
+ Reviewed the <link href="linkalarm-readme.txt">LinkAlarm report</link>
+ and fixed some broken links.
+ </action>
<action dev="DC" type="add" fixes-bug="8989"
due-to="Andreas Hochsteger" due-to-email="[EMAIL PROTECTED]">
1.4 +16 -0 xml-cocoon2/src/documentation/xdocs/plan/doc.xml
Index: doc.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/plan/doc.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- doc.xml 9 May 2002 05:49:27 -0000 1.3
+++ doc.xml 13 May 2002 16:24:17 -0000 1.4
@@ -38,6 +38,15 @@
</ul>
</s2>
+ <s2 title="XSP Internals">
+ <ul>
+ <li>This document (userdocs/xsp/xsp-internals.xml) had stacks of broken
+ links to old Javadocs. Perhaps this indicates that the whole document
+ needs revision.
+ </li>
+ </ul>
+ </s2>
+
</s1>
<s1 title="Fix any placeholder documents">
@@ -76,6 +85,13 @@
<li>All documentation needs to be continually revised. It cannot be written
and then never updated. It needs to keep in step with the code and
configuration changes.
+ </li>
+
+ <li>The excellent LinkAlarm service is used after each major public release
+ of Cocoon to help discover any broken internal or external links. Please
+ see the README file at
+ <link href="linkalarm-readme.txt">linkalarm-readme.txt</link>
+ and help to attend to any issues.
</li>
</ul>
1.1 xml-cocoon2/src/documentation/xdocs/plan/linkalarm-broken.txt
Index: linkalarm-broken.txt
===================================================================
#----------------------------------------------------------------
# LinkAlarm last run on 2002-05-12 after 2.0.2 release
#
#status problem_link referring_page response_code meaning comment
#----------------------------------------------------------------
F http://localhost:8080/cocoon/
http://xml.apache.org/cocoon/installing/index.html 408 Request timeout (5
attempts) There were 7 similar errors.
- http://localhost:8080/cocoon/ctwig/basic01-01.html
http://xml.apache.org/cocoon/ctwig/ctwig-basic01.html 408 Request timeout (5
attempts) There were 4 similar errors
4 http://politics.smallworld.com/ http://xml.apache.org/cocoon/livesites.html
408 Request timeout (5 attempts) -
1 http://store.learningnetwork.com/main/index.xml
http://xml.apache.org/cocoon/livesites.html 404 Not found -
1 http://www.aromax.hu/ http://xml.apache.org/cocoon/livesites.html 408
Request timeout (5 attempts) -
4 http://www.bigfoot.com/~davidsont/jstyle
http://xml.apache.org/cocoon/userdocs/xsp/xsp-internals.html 404 Not Found
-
1 http://www.earthtrip.com/ http://xml.apache.org/cocoon/livesites.html
904 Can't connect to www.earthtrip.com:80 (Bad hostname 'www.earthtrip.com')
-
1 http://www.mtnartinst.com/ http://xml.apache.org/cocoon/livesites.html
904 Can't connect to www.mtnartinst.com:80 (Bad hostname 'www.mtnartinst.com')
-
1 http://www.smb-tec.com:7070/ http://xml.apache.org/cocoon/livesites.html
408 Request timeout (5 attempts) -
1 http://www.snow-news.com/ http://xml.apache.org/cocoon/livesites.html
408 Request timeout (5 attempts) -
F http://xml.apache.org/cocoon/apidocs/org/apache/arch/named/NamedComponent.html
http://xml.apache.org/cocoon/userdocs/xsp/xsp-internals.html 404 Not Found
There were 8 similar errors linking to old javadocs.
F
http:[EMAIL PROTECTED]
http://xml.apache.org/cocoon/apidocs/org/apache/cocoon/components/profiler/ProfilingSAXConnector.html
404 Not Found -
F
http:[EMAIL PROTECTED]
http://xml.apache.org/cocoon/apidocs/org/apache/cocoon/environment/WriteableSource.html
404 Not Found -
F http://xml.apache.org/cocoon/dist
http://xml.apache.org/cocoon/index.html 301 Redirected to <A
HREF="http://xml.apache.org/cocoon/dist/";>http://xml.apache.org/cocoon/dist/</A>
-
- http://xml.apache.org/cocoon/dist/images/cocoon.jpg
http://xml.apache.org/cocoon/dist/cocoon1/ 404 Not Found There were 9
errors like this.
- http://xml.apache.org/cocoon/images/cocoon2.gif
http://xml.apache.org/cocoon/dist/ 404 Not Found There were 9 errors
like this.
? http://xml.apache.org/cocoon/userdocs/concepts/samples/catalog-demo
http://xml.apache.org/cocoon/userdocs/concepts/catalog.html 404 Not Found
Still not sure how to link from doc to sample.
1.1 xml-cocoon2/src/documentation/xdocs/plan/linkalarm-readme.txt
Index: linkalarm-readme.txt
===================================================================
The LinkAlarm report for xml.apache.org/cocoon/ is at
http://reports.linkalarm.com/373104199608/
LinkAlarm scans are run after each public release of Cocoon
to detect any issues that need to be addressed prior to the
next release.
The LinkAlarm report gives detailed HTML views of the situation
in an easy-to-read style. However, the summary file that is
explained below has concise info about the actual broken links.
One other LinkAlarm page that is of special interest is the
"mailto:"; validation page (those errors are not included in
the summary listing below).
To facilitate the management of link mending by the Cocoon
community, there is a summary file in the HEAD CVS at
documentation/xdocs/plan/linkalarm-broken.txt
This tab-delimited file has the following format ...
status problem_link referring_page response_code meaning comment
where "status" has these codes ...
- ... not yet addressed
F ... fixed
? ... has some issue (see the "comment" field)
[1-3] ... external link broken for n runs (will be dropped soon)
To reduce duplication of effort, please update the "status"
tag for each issue that you have addressed.
----------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
