This is an automated email from the ASF dual-hosted git repository.

robertlazarski pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/axis-axis2-java-core.git


The following commit(s) were added to refs/heads/master by this push:
     new 3f34922dba Axis2 site build updates, use AI to update broken http 
links if possible and document what is unable to be fixed
3f34922dba is described below

commit 3f34922dba34005203160efbc763b6e9826f1375
Author: Robert Lazarski <[email protected]>
AuthorDate: Mon Nov 3 12:54:47 2025 -1000

    Axis2 site build updates, use AI to update broken http links if possible 
and document what is unable to be fixed
---
 modules/samples/pojoguide/README.txt               |   5 +-
 modules/samples/pojoguidespring/README.txt         |   5 +-
 modules/samples/quickstart/README.txt              |   5 +-
 modules/samples/quickstartadb/README.txt           |   5 +-
 modules/samples/quickstartaxiom/README.txt         |   5 +-
 modules/samples/quickstartjibx/README.txt          |   5 +-
 modules/samples/quickstartxmlbeans/README.txt      |   5 +-
 modules/samples/userguide/README.txt               |  11 +-
 src/site/xdoc/articles.xml                         | 136 +++++++++++----------
 src/site/xdoc/docs/Axis2ArchitectureGuide.xml      |   2 +-
 src/site/xdoc/docs/app_server.xml                  |   8 +-
 src/site/xdoc/docs/installationguide.xml.vm        |  31 ++---
 src/site/xdoc/docs/json_support.xml                |   2 +-
 src/site/xdoc/docs/mail-transport.xml              |   9 +-
 src/site/xdoc/docs/modules.xml                     |   4 +-
 src/site/xdoc/docs/rest-ws.xml                     |   4 +-
 .../xdoc/docs/userguide-creatingclients-jibx.xml   |  20 +--
 src/site/xdoc/docs/userguide.xml                   |  20 +--
 src/site/xdoc/git.xml                              |   4 +-
 src/site/xdoc/refLib.xml                           |  12 +-
 src/site/xdoc/tools/eclipse/wsdl2java-plugin.xml   |   2 +-
 21 files changed, 139 insertions(+), 161 deletions(-)

diff --git a/modules/samples/pojoguide/README.txt 
b/modules/samples/pojoguide/README.txt
index 2fa903279c..31d3f9a98f 100644
--- a/modules/samples/pojoguide/README.txt
+++ b/modules/samples/pojoguide/README.txt
@@ -1,8 +1,7 @@
 POJO Web Services using Apache Axis2- Sample 1
 =============================================
-This sample contains source code for the xdocs/1_1/pojoguide.html document 
found in 
-the extracted Axis2 Documents Distribution. For a more detailed description on 
the 
-source code kindly see this 'POJO Web Services using Apache Axis2' document.
+This sample contains source code for the POJO Web Services guide. For a more 
detailed
+description on the source code, see the 'POJO Web Services using Apache Axis2' 
documentation.
 
 The above mentioned document shows you how to take a simple POJO (Plain Old 
Java 
 Object), and deploy it on Apache Tomcat as a Web service in the exploded 
directory 
diff --git a/modules/samples/pojoguidespring/README.txt 
b/modules/samples/pojoguidespring/README.txt
index d6c2b95768..f822c39e42 100644
--- a/modules/samples/pojoguidespring/README.txt
+++ b/modules/samples/pojoguidespring/README.txt
@@ -1,8 +1,7 @@
 POJO Web Services using Apache Axis2- Sample 2
 ==============================================
-This sample contains source code for the xdocs/1_1/pojoguide.html document 
found in 
-the extracted Axis2 Documents Distribution. For a more detailed description on 
the 
-source code kindly see this 'POJO Web Services using Apache Axis2' document.
+This sample contains source code for the POJO Web Services guide. For a more 
detailed
+description on the source code, see the 'POJO Web Services using Apache Axis2' 
documentation.
 
 In this specific sample you'll be shown how to take a POJO  (Plain Old Java 
Object) 
 based on the Spring Framework, and deploy that as an AAR packaged Web service 
on Tomcat. 
diff --git a/modules/samples/quickstart/README.txt 
b/modules/samples/quickstart/README.txt
index c335050985..6a12450343 100644
--- a/modules/samples/quickstart/README.txt
+++ b/modules/samples/quickstart/README.txt
@@ -1,9 +1,8 @@
 Axis2 Quick Start Guide- Sample 1
 =================================
 
-This sample contains source code for the xdocs/1_1/quickstartguide.html 
document found in 
-the extracted Axis2 Documents Distribution. For a more detailed description on 
the 
-source code kindly see this 'Axis2 Quick Start Guide' document.
+This sample contains source code for the Axis2 Quick Start Guide. For a more 
detailed
+description on the source code, see the Axis2 Quick Start Guide documentation.
 
 Introduction
 ============
diff --git a/modules/samples/quickstartadb/README.txt 
b/modules/samples/quickstartadb/README.txt
index 36a940fd5d..981ba576fc 100644
--- a/modules/samples/quickstartadb/README.txt
+++ b/modules/samples/quickstartadb/README.txt
@@ -1,9 +1,8 @@
 Axis2 Quick Start Guide- Sample 2 (ADB)
 ======================================
 
-This sample contains source code for the site/docs/quickstartguide.html 
document found in 
-the extracted Axis2 Documents Distribution. For a more detailed description on 
the 
-source code kindly see this 'Axis2 Quick Start Guide' document.
+This sample contains source code for the Axis2 Quick Start Guide. For a more 
detailed
+description on the source code, see the Axis2 Quick Start Guide documentation.
 
 Introduction
 ============
diff --git a/modules/samples/quickstartaxiom/README.txt 
b/modules/samples/quickstartaxiom/README.txt
index 26e6487708..31c114b8c4 100644
--- a/modules/samples/quickstartaxiom/README.txt
+++ b/modules/samples/quickstartaxiom/README.txt
@@ -1,9 +1,8 @@
 Axis2 Quick Start Guide - Sample 3 (AXIOM)
 ==========================================
 
-This sample contains source code for the xdocs/1_1/quickstartguide.html 
document found in 
-the extracted Axis2 Documents Distribution. For a more detailed description on 
the 
-source code kindly see this 'Axis2 Quick Start Guide' document.
+This sample contains source code for the Axis2 Quick Start Guide. For a more 
detailed
+description on the source code, see the Axis2 Quick Start Guide documentation.
 
 Introduction
 ============
diff --git a/modules/samples/quickstartjibx/README.txt 
b/modules/samples/quickstartjibx/README.txt
index 5a21fc088e..eae52de563 100644
--- a/modules/samples/quickstartjibx/README.txt
+++ b/modules/samples/quickstartjibx/README.txt
@@ -1,8 +1,7 @@
 Axis2 Quick Start Guide- (JiBX)
 ======================================
-This sample contains source code for the xdocs/1_1/quickstartguide.html 
document found in 
-the extracted Axis2 Documents Distribution. For a more detailed description on 
the 
-source code kindly see this 'Axis2 Quick Start Guide' document.
+This sample contains source code for the Axis2 Quick Start Guide. For a more 
detailed
+description on the source code, see the Axis2 Quick Start Guide documentation.
 
 Introduction
 ============
diff --git a/modules/samples/quickstartxmlbeans/README.txt 
b/modules/samples/quickstartxmlbeans/README.txt
index d227eee0e7..a8b7ddc13c 100644
--- a/modules/samples/quickstartxmlbeans/README.txt
+++ b/modules/samples/quickstartxmlbeans/README.txt
@@ -1,9 +1,8 @@
 Axis2 Quick Start Guide- Sample 4 (XML Beans)
 ============================================
 
-This sample contains source code for the xdocs/1_1/quickstartguide.html 
document found in 
-the extracted Axis2 Documents Distribution. For a more detailed description on 
the 
-source code kindly see this 'Axis2 Quick Start Guide' document.
+This sample contains source code for the Axis2 Quick Start Guide. For a more 
detailed
+description on the source code, see the Axis2 Quick Start Guide documentation.
 
 Introduction
 ============
diff --git a/modules/samples/userguide/README.txt 
b/modules/samples/userguide/README.txt
index cf4d8d189c..bf5db7ef53 100644
--- a/modules/samples/userguide/README.txt
+++ b/modules/samples/userguide/README.txt
@@ -1,9 +1,8 @@
 Axis2 User's Guide Sample
 =========================
 
-This sample contains the source code relevant to xdocs/1_1/adv-userguide.html, 
-more specifically to xdocs/1_1/dii.html and xmlbased-server.html which are 
sections 
-of the Axis2 Advanced User's Guide found in the Documents Distribution.
+This sample contains the source code relevant to the Axis2 Advanced User's 
Guide,
+more specifically the DII (Dynamic Invocation Interface) and XML-based server 
sections.
 
 The sample explains how to write a Web service and Web service client with 
 Apache Axis2 using XML based client APIs (Axis2's Primary APIs).
@@ -76,9 +75,9 @@ Type the following ant commands from 
Axis2_HOME/samples/userguide to run the cli
    This invokes MyService through a one-way client
 
  
-You can find more information on the above clients in Axis2 users guide, 
RESTFul Web services support, 
-TCP Transport documents found in the Documents Distribution's xdocs directory. 
Also, you may find it 
-useful to try out the above services and clients while going through these 
documents.
+You can find more information on the above clients in the Axis2 User's Guide, 
RESTful Web services support,
+and TCP Transport documentation. You may find it useful to try out the above 
services and clients while
+going through the project documentation.
 
 Note
 ==============
diff --git a/src/site/xdoc/articles.xml b/src/site/xdoc/articles.xml
index ef83b59eb4..d12d76b42b 100644
--- a/src/site/xdoc/articles.xml
+++ b/src/site/xdoc/articles.xml
@@ -37,6 +37,13 @@
 question and answers published on various Web sites on the Apache
 Axis2 engine. These references will prove to be a great help in
 boosting your knowledge on Axis2.</p>
+
+<div style="background-color: #f8f8f8; border: 1px solid #ccc; padding: 10px; 
margin: 10px 0;">
+<strong>Note:</strong> Many of the external links below may no longer be 
accessible due to website changes,
+domain transfers, or content removal over time. For the most current Axis2 
documentation and tutorials,
+please refer to the <a href="docs/userguide.html">official Axis2 User 
Guide</a> and
+<a href="https://axis.apache.org/";>Apache Axis website</a>.
+</div>
 <h2>Books:</h2>
 <ul>
 <li><a class="externalLink" 
href="https://www.packtpub.com/apache-axis2-web-services/book";>
@@ -52,78 +59,78 @@ Quicktstart Apache Axis2</a>
 </ul>
 <h2>Articles:</h2>
 <ul>
-<li><a href=
+<li><s><a href=
 "http://www.jaxmag.com/itr/online_artikel/psecom,id,747,nodeid,147.html";>
-Axis2 - The Future of Web Services</a>- By Srinath Perera, Ajith
+Axis2 - The Future of Web Services</a></s> <em>(JAXMag may be 
inaccessible)</em>- By Srinath Perera, Ajith
 Ranabahu</li>
-<li><a href=
+<li><s><a href=
 "http://www.developer.com/services/article.php/3525481";>Introducing
-Axis2, the Next Generation of the Apache Web Service Stack</a>- By
+Axis2, the Next Generation of the Apache Web Service Stack</a></s> 
<em>(Developer.com may be inaccessible)</em>- By
 Srinath Perera</li>
 <li><a href=
 "http://www.onjava.com/pub/a/onjava/2005/07/27/axis2.html";>Web
 Services Messaging with Apache Axis2: Concepts and Techniques</a>-
 By Srinath Perera, Ajith Ranabahu (27 July 2005)</li>
-<li><a href=
+<li><s><a href=
 "http://developer.com/java/web/article.php/3529321";>Axis2 Execution
-Framework</a>- By Deepal Jayasinghe</li>
-<li><a href=
+Framework</a></s> <em>(Developer.com may be inaccessible)</em>- By Deepal 
Jayasinghe</li>
+<li><s><a href=
 "http://jaxmag.com/itr/online_artikel/psecom,id,757,nodeid,147.html";>
-Axis2 Deployment Model</a>- By Deepal Jayasinghe</li>
-<li><a href=
+Axis2 Deployment Model</a></s> <em>(JAXMag may be inaccessible)</em>- By 
Deepal Jayasinghe</li>
+<li><s><a href=
 "http://www.developer.com/open/article.php/3557741";>Understanding
-Axis2 Deployment Architecture</a>- By Deepal Jayasinghe</li>
+Axis2 Deployment Architecture</a></s> <em>(Developer.com may be 
inaccessible)</em>- By Deepal Jayasinghe</li>
 <li><a href=
 "http://wso2.org/library/35";>
 Inside the Axis2 Code Generator</a>- By Ajith Ranabahu (06 Feb
 2006)</li>
-<li><a href=
+<li><s><a href=
 "http://www.developer.com/java/other/article.php/3570031";>Utilizing
-a Non-Java Web Service with Axis2</a>- By Deepal Jayasinghe</li>
-<li><a href=
+a Non-Java Web Service with Axis2</a></s> <em>(Developer.com may be 
inaccessible)</em>- By Deepal Jayasinghe</li>
+<li><s><a href=
 "http://www.developer.com/open/article.php/3589126";>Avoiding
-Mistakes Made Using Axis2</a>- By Deepal Jayasinghe</li>
-<li><a href=
+Mistakes Made Using Axis2</a></s> <em>(Developer.com may be 
inaccessible)</em>- By Deepal Jayasinghe</li>
+<li><s><a href=
 "http://www-128.ibm.com/developerworks/java/library/os-ag-axis2mig/index.html";>
-Migrating Apache Axis apps to Axis2 using Apache Geronimo</a>- By
+Migrating Apache Axis apps to Axis2 using Apache Geronimo</a></s> <em>(Old IBM 
DeveloperWorks URL format may be inaccessible)</em>- By
 Tyler Anderson (07 Mar 2006)</li>
-<li><a href=
+<li><s><a href=
 "http://www.developer.com/java/ent/article.php/3606466";>The Axis2
-Transport Framework</a>- By Deepal Jayasinghe</li>
-<li><a href=
+Transport Framework</a></s> <em>(Developer.com may be inaccessible)</em>- By 
Deepal Jayasinghe</li>
+<li><s><a href=
 "http://wso2.org/library/230";>
-Reference Guide to Apache Axis2 Client API Parameters</a>- By Eran
+Reference Guide to Apache Axis2 Client API Parameters</a></s> <em>(WSO2 
library may be inaccessible)</em>- By Eran
 Chinthaka (01 Aug 2006)</li>
-<li><a href=
+<li><s><a href=
 "http://wso2.org/library/91";>
-Axis2 - Performance Testing Round #1</a>- By
+Axis2 - Performance Testing Round #1</a></s> <em>(WSO2 library may be 
inaccessible)</em>- By
 Devanum Sirinivas (17 May 2006)</li>
-<li><a href=
+<li><s><a href=
 "http://wso2.org/library/259";>
-Working With Apache Axis2</a>- Deepal Jayasinghe (13 Sep 2006)</li>
-<li><a href=
+Working With Apache Axis2</a></s> <em>(WSO2 library may be inaccessible)</em>- 
Deepal Jayasinghe (13 Sep 2006)</li>
+<li><s><a href=
 "http://www.developer.com/java/ent/article.php/3613896";>Writing an
-Apache Axis2 Service from Scratch</a>- By Deepal Jayasinghe (20
+Apache Axis2 Service from Scratch</a></s> <em>(Developer.com may be 
inaccessible)</em>- By Deepal Jayasinghe (20
 June 2006)</li>
-<li><a href=
+<li><s><a href=
 "http://www.developer.com/java/web/article.php/3620661";>Apache
-Axis2 Session Management</a>- By Deepal Jayasinghe</li>
+Axis2 Session Management</a></s> <em>(Developer.com may be inaccessible)</em>- 
By Deepal Jayasinghe</li>
 <li><a href="http://www.devx.com/Java/Article/33839";>Apache Axis2
 with POJO's and Spring</a>- By Ramanujam A. Rao</li>
 
-<li><a href=
+<li><s><a href=
 "http://www-128.ibm.com/developerworks/webservices/library/ws-axis2soap/";>
-Six ways the Axis2 deployment model is more user friendly</a>- By Deepal 
Jayasinghe</li>
-<li><a 
href="http://today.java.net/pub/a/today/2006/12/13/invoking-web-services-using-apache-axis2.html";>
-Invoking Web Services using Apache Axis2
-</a>- By Deepal Jayasinghe</li>
-<li><a href="http://wso2.org/library/2060";>
-Writing Your Own services.xml for Axis2 Web Services</a>- By Deepal 
Jayasinghe</li>
-<li><a href="http://wso2.org/library/2068";>
-ADB Generated Code in Apache Axis2</a>- By Amila Suriarachchi</li>
-<li><a 
href="http://wso2.org/library/articles/working-rpcserviceclient";>Working with 
RPCServiceClient</a>- By Deepal Jayasinghe</li>
-<li><a 
href="http://www.developer.com/open/article.php/10930_3777111_2/Embedding-Apache-Axis2-into-Existing-Applications.htm";>Embedding
 Apache Axis2 into Existing Applications</a>- By Deepal Jayasinghe</li>
-<li><a 
href="http://www.developer.com/java/web/article.php/10935_3863416_2/Using-Axis2-and-Java-for-Asynchronous-Web-Service-Invocation-on-the-Client-Side.htm";>Using
 Axis2 and Java for Asynchronous Web Service Invocation on the Client Side</a>- 
By Deepal Jayasinghe</li>
+Six ways the Axis2 deployment model is more user friendly</a></s> <em>(Old IBM 
DeveloperWorks URL format may be inaccessible)</em>- By Deepal Jayasinghe</li>
+<li><s><a 
href="http://today.java.net/pub/a/today/2006/12/13/invoking-web-services-using-apache-axis2.html";>
+Invoking Web Services using Apache Axis2</a></s> <em>(Link no longer 
accessible)</em>
+- By Deepal Jayasinghe</li>
+<li><s><a href="http://wso2.org/library/2060";>
+Writing Your Own services.xml for Axis2 Web Services</a></s> <em>(WSO2 library 
may be inaccessible)</em>- By Deepal Jayasinghe</li>
+<li><s><a href="http://wso2.org/library/2068";>
+ADB Generated Code in Apache Axis2</a></s> <em>(WSO2 library may be 
inaccessible)</em>- By Amila Suriarachchi</li>
+<li><s><a 
href="http://wso2.org/library/articles/working-rpcserviceclient";>Working with 
RPCServiceClient</a></s> <em>(WSO2 library may be inaccessible)</em>- By Deepal 
Jayasinghe</li>
+<li><s><a 
href="http://www.developer.com/open/article.php/10930_3777111_2/Embedding-Apache-Axis2-into-Existing-Applications.htm";>Embedding
 Apache Axis2 into Existing Applications</a></s> <em>(Link may no longer be 
accessible)</em>- By Deepal Jayasinghe</li>
+<li><s><a 
href="http://www.developer.com/java/web/article.php/10935_3863416_2/Using-Axis2-and-Java-for-Asynchronous-Web-Service-Invocation-on-the-Client-Side.htm";>Using
 Axis2 and Java for Asynchronous Web Service Invocation on the Client 
Side</a></s> <em>(Link may no longer be accessible)</em>- By Deepal 
Jayasinghe</li>
 
 
 
@@ -137,45 +144,46 @@ Web services, Part 3: Axis2 Data Binding</a> - By Dennis 
Sosnoski (26 Jul
 
 </ul>
 <h2>Tutorials</h2>
+<p><em><strong>Note:</strong> WSO2.org library links below may be inaccessible 
due to site changes.</em></p>
 <ul>
-<li><a href="http://wso2.org/library/140";>Introducing Axis2</a>- By
+<li><s><a href="http://wso2.org/library/140";>Introducing Axis2</a></s> 
<em>(WSO2 library may be inaccessible)</em>- By
 Eran Chinthaka, Chathura Herath (05 June 2006)</li>
-<li><a href="http://wso2.org/library/141";>Accelerating Web Services
-Development with Axis2</a>- By Deepal Jayasinghe, Ajith Ranabahu
+<li><s><a href="http://wso2.org/library/141";>Accelerating Web Services
+Development with Axis2</a></s> <em>(WSO2 library may be inaccessible)</em>- By 
Deepal Jayasinghe, Ajith Ranabahu
 (05 June 2006)</li>
-<li><a href="http://wso2.org/library/95";>Hello World with Apache
-Axis2</a>- By Ruchith Fernando (29 May 2006)</li>
-<li><a href="http://wso2.org/library/176";>How Apache Axis2 Finds
-the Operation and Service a Message is Destined To</a>- By Eran
+<li><s><a href="http://wso2.org/library/95";>Hello World with Apache
+Axis2</a></s> <em>(WSO2 library may be inaccessible)</em>- By Ruchith Fernando 
(29 May 2006)</li>
+<li><s><a href="http://wso2.org/library/176";>How Apache Axis2 Finds
+the Operation and Service a Message is Destined To</a></s> <em>(WSO2 library 
may be inaccessible)</em>- By Eran
 Chinthaka(18 June 2006)</li>
-<li><a href="http://wso2.org/library/225";>How to Debug a Web
-Service?</a>- By Ajith Ranabahu (28 July 2006)</li>
+<li><s><a href="http://wso2.org/library/225";>How to Debug a Web
+Service?</a></s> <em>(WSO2 library may be inaccessible)</em>- By Ajith 
Ranabahu (28 July 2006)</li>
 </ul>
 <h2>Presentations</h2>
 <ul>
-<li><a href="http://wso2.org/library/136";>Why Axis2: The Future of
-Web Services</a>- By Eran Chinthaka (05 June 2006)</li>
-<li><a href="http://wso2.org/library/247";>Building Enterprise
-Applications with Axis2-Tutorial from ApacheCon Asia 2006</a>- By
+<li><s><a href="http://wso2.org/library/136";>Why Axis2: The Future of
+Web Services</a></s> <em>(WSO2 library may be inaccessible)</em>- By Eran 
Chinthaka (05 June 2006)</li>
+<li><s><a href="http://wso2.org/library/247";>Building Enterprise
+Applications with Axis2-Tutorial from ApacheCon Asia 2006</a></s> <em>(WSO2 
library may be inaccessible)</em>- By
 Deepal Jayasinghe, Ruchith Fernando (30 Aug 2006)</li>
-<li><a href="http://wso2.org/library/137";>Introducing Axis2</a>- By
+<li><s><a href="http://wso2.org/library/137";>Introducing Axis2</a></s> 
<em>(WSO2 library may be inaccessible)</em>- By
 Ajith Ranabahu (05 June 2006)</li>
 </ul>
 <h2>Questions and Answers</h2>
 <ul>
-<li><a href="http://wso2.org/library/67";>Setting up Apache Axis2 in
-eclipse IDE</a>- By Ruchith Fernando (04 April 2006)</li>
-<li><a href="http://wso2.org/library/83";>How do I Embed
-SimpleHTTPServer in My Application and Deploy a POJO?</a>- By
+<li><s><a href="http://wso2.org/library/67";>Setting up Apache Axis2 in
+eclipse IDE</a></s> <em>(WSO2 library may be inaccessible)</em>- By Ruchith 
Fernando (04 April 2006)</li>
+<li><s><a href="http://wso2.org/library/83";>How do I Embed
+SimpleHTTPServer in My Application and Deploy a POJO?</a></s> <em>(WSO2 
library may be inaccessible)</em>- By
 Davanum Sirinivas (09 May 2006)</li>
-<li><a href="http://wso2.org/library/209";>How to Configure Axis2's
-HTTP Transport Sender at Client Side?</a>- By Saminda Abeysinghe
+<li><s><a href="http://wso2.org/library/209";>How to Configure Axis2's
+HTTP Transport Sender at Client Side?</a></s> <em>(WSO2 library may be 
inaccessible)</em>- By Saminda Abeysinghe
 (11July 2006)</li>
-<li><a href="http://wso2.org/library/175";>How to do REST invocation
-with Axis2/Java ServiceClient?</a>- By Eran Chinthaka (17 June
+<li><s><a href="http://wso2.org/library/175";>How to do REST invocation
+with Axis2/Java ServiceClient?</a></s> <em>(WSO2 library may be 
inaccessible)</em>- By Eran Chinthaka (17 June
 2006)</li>
-<li><a href="http://wso2.org/library/90";>How to Embed an Axis2
-based Web Service in your Webapp?</a>- By Davanum Sirinivas(17 May
+<li><s><a href="http://wso2.org/library/90";>How to Embed an Axis2
+based Web Service in your Webapp?</a></s> <em>(WSO2 library may be 
inaccessible)</em>- By Davanum Sirinivas(17 May
 2006)</li>
 </ul>
 </body>
diff --git a/src/site/xdoc/docs/Axis2ArchitectureGuide.xml 
b/src/site/xdoc/docs/Axis2ArchitectureGuide.xml
index a8333f4d2c..23d3ce9759 100644
--- a/src/site/xdoc/docs/Axis2ArchitectureGuide.xml
+++ b/src/site/xdoc/docs/Axis2ArchitectureGuide.xml
@@ -164,7 +164,7 @@ Architecture is built on three specifications- <a href=
 "http://www.w3.org/TR/soap/";>SOAP</a> and <a href=
 "http://www.w3.org/Submission/ws-addressing/";>WS-Addressing</a>.
 Other specifications like JAX-RPC, <a href=
-"http://java.sun.com/webservices/saaj/index.jsp";>SAAJ</a> and
+"https://eclipse-ee4j.github.io/metro-saaj/";>SAAJ</a> and
 <a href="http://www.w3.org/Submission/WS-Policy/";>WS-Policy</a> are
 layered on top of the Core Architecture.</p>
 <a name="thearchi" id="thearchi"></a>
diff --git a/src/site/xdoc/docs/app_server.xml 
b/src/site/xdoc/docs/app_server.xml
index 8659653ab2..e9d7f24cc1 100644
--- a/src/site/xdoc/docs/app_server.xml
+++ b/src/site/xdoc/docs/app_server.xml
@@ -65,13 +65,13 @@
                 <p>Please refer to the following documents in WebLogic
                 for more information:</p>
                 <ul>
-                <li><a href=
+                <li><s><a href=
                 
"http://e-docs.bea.com/wls/docs81/programming/classloading.html";>WebLogic
-                ServerApplication Classloading</a>- For more information on how
+                ServerApplication Classloading</a></s> <em>(BEA docs may be 
inaccessible since Oracle acquisition)</em>- For more information on how
                 WebLogic's class loader works</li>
-                <li><a href=
+                <li><s><a href=
                 
"http://e-docs.bea.com/wls/docs81/webapp/deployment.html";>Redeploying
-                a Web Application in Exploded Directory Format</a></li>
+                a Web Application in Exploded Directory Format</a></s> 
<em>(BEA docs may be inaccessible since Oracle acquisition)</em></li>
                 </ul>
             </subsection>
             <subsection name="Lack of namespacing on serialised items">
diff --git a/src/site/xdoc/docs/installationguide.xml.vm 
b/src/site/xdoc/docs/installationguide.xml.vm
index 48330b6a15..62a7be16b8 100644
--- a/src/site/xdoc/docs/installationguide.xml.vm
+++ b/src/site/xdoc/docs/installationguide.xml.vm
@@ -96,12 +96,7 @@ Download</a> Standard Binary Distribution</p>
 most of the servlet containers.</p>
 <p><a href="../download.cgi">
 Download</a> WAR (Web Archive) Distribution</p>
-<h3>3. Documents Distribution</h3>
-<p>This contains all the documentation in one package. The package
-includes the xdocs and the Java API docs of this project.</p>
-<p><a href="../download.cgi">
-Download</a> Documents Distribution</p>
-<h3>4. Source Distribution</h3>
+<h3>3. Source Distribution</h3>
 <p>This contains the sources of Axis2 standard distribution, and is
 mainly for the benefit of advanced users. One can generate a binary
 distribution using the source by typing <span class="style1">$mvn
@@ -117,9 +112,9 @@ Download</a> Source Distribution</p>
 <tbody>
 <tr>
 <td>Java Development Kit (JDK)</td>
-<td>1.8 or later (For instructions on setting up the JDK in
+<td>17 or later (For instructions on setting up OpenJDK in
 different operating systems, visit <a href=
-"http://java.sun.com/";>http://java.sun.com</a>)</td>
+"https://openjdk.org/";>https://openjdk.org/</a> - we only support OpenJDK)</td>
 </tr>
 <tr>
 <td>Disk</td>
@@ -132,21 +127,21 @@ distribution</td>
 </tr>
 <tr>
 <td><strong>Build Tool</strong>-<a href=
-"http://ant.apache.org/";>Apache Ant</a>
+"https://ant.apache.org/";>Apache Ant</a>
 <p>To run samples and to build WAR files from Axis2 binary
 distribution.</p>
 </td>
 <td>Version 1.10 or higher (<a href=
-"http://ant.apache.org/bindownload.cgi";>download</a>).</td>
+"https://ant.apache.org/bindownload.cgi";>download</a>).</td>
 </tr>
 <tr>
 <td><strong>Build Tool</strong>- <a href=
-"http://maven.apache.org/";>Apache Maven 2.x</a>
+"https://maven.apache.org/";>Apache Maven 2.x</a>
 <p>Required <em>only</em> for building Axis2 from Source
 Distribution</p>
 </td>
 <td>3.6.3 or higher in Maven 3.x series (<a href=
-"http://maven.apache.org/download.html";>download</a>).
+"https://maven.apache.org/download.html";>download</a>).
 <strong>Please download Maven 3.x version. Axis2 does not support
 Maven 1.x nor 2.x anymore.</strong></td>
 </tr>
@@ -170,7 +165,7 @@ compliant servlet container</li>
 </ol>
 <h3>1. Download and Install the Apache Axis2 Binary
 Distribution</h3>
-<p><a href="http://java.sun.com/j2se/";>Download</a> and install a
+<p><a href="https://openjdk.org/install/";>Download</a> and install an OpenJDK
 Java Development Kit (JDK) release (version 17 or later). Install
 the JDK according to the instructions included with the release.
 Set an environment variable JAVA_HOME to the pathname of the
@@ -193,7 +188,7 @@ be available by visiting 
http://localhost:8080/axis2/services/</p>
 <a name="standalone3" id="standalone3"></a>
 <h3>3. Building the Axis2 Web Application (axis2.war) Using
 Standard Binary Distribution</h3>
-<p><a href="http://ant.apache.org/bindownload.cgi";>Download</a> and
+<p><a href="https://ant.apache.org/bindownload.cgi";>Download</a> and
 install Apache Ant (version 1.10 or later). Install Apache Ant
 according to the instructions included with the Ant release.</p>
 <p>Locate the Ant build file (build.xml) inside the webapp
@@ -360,20 +355,20 @@ distribution</a>) can be built using Maven commands.
 <p>Required jar files do not come with the distribution and they
 will also have to be built by running the maven command. Before we
 go any further, it is necessary to install <a href=
-"http://maven.apache.org/";>Maven3</a> and
+"https://maven.apache.org/";>Maven3</a> and
 set up its environment, as explained below.</p>
 <a name="env-src" id="env-src"></a>
 <h3>Setting Up the Environment and Tools</h3>
 <a name="maven" id="maven"></a>
 <h4>Maven</h4>
 <p>The Axis2 build is based on <a href=
-"http://maven.apache.org/";>Maven3</a> .
+"https://maven.apache.org/";>Maven3</a> .
 Hence the only prerequisite to build Axis2 from the source
 distribution is to have Maven installed. Extensive instruction
 guides are available at the Maven site. This guide however contains
 the easiest path for quick environment setting. Advanced users who
 wish to know more about Maven can visit <a href=
-"http://maven.apache.org/users/index.html";>this site.</a></p>
+"https://maven.apache.org/users/index.html";>this site.</a></p>
 <ul>
 <li>MS Windows</li>
 </ul>
@@ -396,7 +391,7 @@ location of your JDK, eg. C:\Program 
Files\Java\jdk1.5.0_11</li>
 archive is downloaded expand it to a directory of choice and set
 the environment variable MAVEN_HOME and add MAVEN_HOME/bin to the
 path as well. <a href=
-"http://maven.apache.org/download.html";>More
+"https://maven.apache.org/download.html";>More
 instructions</a> for installing Maven in Unix based operating
 systems.</p>
 <p>Once Maven is properly installed, you can start building
diff --git a/src/site/xdoc/docs/json_support.xml 
b/src/site/xdoc/docs/json_support.xml
index 8f367be5a9..0010f9368c 100644
--- a/src/site/xdoc/docs/json_support.xml
+++ b/src/site/xdoc/docs/json_support.xml
@@ -212,7 +212,7 @@ HTTP/1.1</code>
                 <code>JSONBadgerfishOMBuilder</code> convert incoming messages 
from JSON to XML and
                 the two message formatters <code>JSONMessageFormatter</code> 
and <code>JSONBadgerfishMessageFormatter</code>
                 convert outgoing messages from XML to JSON. Axis2 doesn't 
implement its own JSON parser and serializer, and
-                instead relies on <a 
href="http://jettison.codehaus.org/";>Jettison</a> to do the JSON&lt;->XML 
conversions.</p>
+                instead relies on <s><a 
href="http://jettison.codehaus.org/";>Jettison</a></s> <em>(Codehaus hosting no 
longer accessible - project moved to <a 
href="https://github.com/jettison-json/jettison";>GitHub</a>)</em> to do the 
JSON&lt;->XML conversions.</p>
                 <p>On the server side the XML for an incoming
                 message is typically converted to Java objects by a 
databinding (such as ADB or JAX-WS)
                 before the invocation of the service implementation. In the 
same way, the Java object returned by the
diff --git a/src/site/xdoc/docs/mail-transport.xml 
b/src/site/xdoc/docs/mail-transport.xml
index 92ec83ac9c..ab1f231b03 100644
--- a/src/site/xdoc/docs/mail-transport.xml
+++ b/src/site/xdoc/docs/mail-transport.xml
@@ -26,7 +26,7 @@
             <p>The mail transport allows to send and receive messages using 
MIME compliant mail messages. The transport sender
             transmits outgoing messages using SMTP, while the transport 
listener connects to one or more mail accounts
             and periodically polls these accounts for new incoming messages. 
The implementation is based on
-            <a href="http://java.sun.com/products/javamail/";>JavaMail</a> and 
therefore supports any mail store protocol
+            <a href="https://eclipse-ee4j.github.io/mail/";>Jakarta Mail</a> 
(formerly JavaMail) and therefore supports any mail store protocol
             for which a JavaMail provider is available.</p>
         </section>
         <section name="Transport listener">
@@ -44,9 +44,10 @@
             <p>All parameters starting with <tt>mail.</tt> are
             interpreted as JavaMail environment properties. The most relevant 
are <tt>mail.<em>&lt;protocol&gt;</em>.host</tt>
             and <tt>mail.<em>&lt;protocol&gt;</em>.user</tt>, where 
<tt><em>&lt;protocol&gt;</em></tt> is typically <tt>pop3</tt>
-            or <tt>imap</tt>. Assuming that Sun's JavaMail implementation is 
used, the complete list of supported properties for these
-            two protocols can be found <a 
href="http://java.sun.com/products/javamail/javadocs/com/sun/mail/pop3/package-summary.html";>here</a>
-            and <a 
href="http://java.sun.com/products/javamail/javadocs/com/sun/mail/imap/package-summary.html";>here</a>.</p>
+            or <tt>imap</tt>. The complete list of supported properties for 
these
+            two protocols can be found in the <a 
href="https://eclipse-ee4j.github.io/mail/docs/api/";>Jakarta Mail API 
documentation</a>
+            (for <a 
href="https://eclipse-ee4j.github.io/mail/docs/api/com.sun.mail.pop3/com/sun/mail/pop3/package-summary.html";>POP3</a>
+            and <a 
href="https://eclipse-ee4j.github.io/mail/docs/api/com.sun.mail.imap/com/sun/mail/imap/package-summary.html";>IMAP</a>).</p>
             <p>In additional to the JavaMail environment properties, the 
following transport specific service parameters are
             used:</p>
             <table class="bodyTable">
diff --git a/src/site/xdoc/docs/modules.xml b/src/site/xdoc/docs/modules.xml
index 2fbfd3266f..e9928bce64 100644
--- a/src/site/xdoc/docs/modules.xml
+++ b/src/site/xdoc/docs/modules.xml
@@ -225,9 +225,9 @@ handler runs.</p>
 &lt;order phase="loggingPhase" /&gt;
 &lt;/handler&gt;
 </pre>
-<p>To learn more about Phase rules, check out the article <a href=
+<p>To learn more about Phase rules, check out the article <s><a href=
 "http://www.developer.com/java/web/article.php/3529321";
->Axis2 Execution Framework</a></p>
+>Axis2 Execution Framework</a></s> <em>(Developer.com may be 
inaccessible)</em></p>
 <a name="Step_4:_Modify_the_&quot;axis2_xml&quot;"></a>
 <h4>Step 4: Modify the "axis2.xml"</h4>
 <p>In this handler, the "loggingPhase", is defined by the module
diff --git a/src/site/xdoc/docs/rest-ws.xml b/src/site/xdoc/docs/rest-ws.xml
index e22d6b5dec..fe204e1d78 100644
--- a/src/site/xdoc/docs/rest-ws.xml
+++ b/src/site/xdoc/docs/rest-ws.xml
@@ -168,7 +168,7 @@ 
href="http://naeblis.cx/articles/2004/12/12/rest-to-my-wife";>http://naeblis.cx/a
 href="http://www.xfront.com/REST-Web-Services.html";>
 http://www.xfront.com/REST-Web-Services.html</a></p>
 
-<p>Resource-oriented vs. activity-oriented Web services, By James Snell- <a
-href="http://www-128.ibm.com/developerworks/webservices/library/ws-restvsoap/";>http://www-128.ibm.com/developerworks/webservices/library/ws-restvsoap/</a></p>
+<p>Resource-oriented vs. activity-oriented Web services, By James Snell- <s><a
+href="http://www-128.ibm.com/developerworks/webservices/library/ws-restvsoap/";>http://www-128.ibm.com/developerworks/webservices/library/ws-restvsoap/</a></s>
 <em>(Old IBM DeveloperWorks URL format may be inaccessible)</em></p>
 </body>
 </html>
diff --git a/src/site/xdoc/docs/userguide-creatingclients-jibx.xml 
b/src/site/xdoc/docs/userguide-creatingclients-jibx.xml
index a3b6dd4865..d45c860909 100644
--- a/src/site/xdoc/docs/userguide-creatingclients-jibx.xml
+++ b/src/site/xdoc/docs/userguide-creatingclients-jibx.xml
@@ -240,18 +240,18 @@ with. To generate your client, execute the following 
steps:</p>
 <ol>
 <li>Download the latest JiBX package (tested with JiBX v1.1) from
 <a href=
-"http://sourceforge.net/projects/jibx/";>http://sourceforge.net/projects/jibx/</a>
+"https://sourceforge.net/projects/jibx/";>https://sourceforge.net/projects/jibx/</a>
 . Extract the zip file, and copy the JARs in the lib directory to
 the AXIS2_HOME/lib directory. (Delete the stax-api.jar file; it's
 superseded by the version that comes with Axis2.)</li>
-<li>Download <a href=
+<li>Download <s><a href=
 
"http://sourceforge.net/project/showfiles.php?group_id=69358&amp;package_id=122897";>
-xsd2jibx version beta2a</a> from SourceForge. Create a directory
+xsd2jibx version beta2a</a></s> <em>(Old SourceForge URL format - see <a 
href="https://sourceforge.net/projects/jibx/files/";>JiBX files</a>)</em> from 
SourceForge. Create a directory
 called xsd2jibx in your working directory and extract the files
 into it. This utility does not work with the latest release (v1.1)
-of JiBX, so download <a href=
+of JiBX, so download <s><a href=
 
"http://sourceforge.net/project/showfiles.php?group_id=69358&amp;package_id=68290";>
-jibx-1.0RC1</a> from SourceForge. Extract the files from this
+jibx-1.0RC1</a></s> <em>(Old SourceForge URL format - see <a 
href="https://sourceforge.net/projects/jibx/files/";>JiBX files</a>)</em> from 
SourceForge. Extract the files from this
 archive and copy the *.jar files in the lib directory into the
 xsd2jibx/lib directory.</li>
 <li>Create a schema based on the data structures of your WSDL file
@@ -298,19 +298,19 @@ to create the actual object. In order to do all that 
you'll need to
 have the appropriate versions of the JiBX software.</p>
 <p>Download the latest JiBX package (tested with JiBX v1.1) from
 <a href=
-"http://sourceforge.net/projects/jibx/";>http://sourceforge.net/projects/jibx/</a>.
+"https://sourceforge.net/projects/jibx/";>https://sourceforge.net/projects/jibx/</a>.
 Extract the zip file, and copy the JARs in the lib directory to the
 AXIS2_HOME/lib directory. (Delete the stax-api.jar file; it's
 superseded by the version that comes with Axis2.) These files
 pertain to the main JiBX application.</p>
-<p>Download <a href=
+<p>Download <s><a href=
 
"http://sourceforge.net/project/showfiles.php?group_id=69358&amp;package_id=122897";>
-xsd2jibx version beta2a</a> from Sourceforge. Create a directory
+xsd2jibx version beta2a</a></s> <em>(Old SourceForge URL format - see <a 
href="https://sourceforge.net/projects/jibx/files/";>JiBX files</a>)</em> from 
Sourceforge. Create a directory
 called xsd2jibx in your working directory and extract the files
 into it. Unfortunately, this utility does not work with the latest
-release of JiBX, so you will need to download <a href=
+release of JiBX, so you will need to download <s><a href=
 
"http://sourceforge.net/project/showfiles.php?group_id=69358&amp;package_id=68290";>
-jibx-1.0RC1</a> from Sourceforge. Extract the files from this
+jibx-1.0RC1</a></s> <em>(Old SourceForge URL format - see <a 
href="https://sourceforge.net/projects/jibx/files/";>JiBX files</a>)</em> from 
Sourceforge. Extract the files from this
 archive and place the *.jar files in the lib directory into the
 xsd2jibx/lib directory. This way, you can use them exclusively with
 the xsd2jibx utility.</p>
diff --git a/src/site/xdoc/docs/userguide.xml b/src/site/xdoc/docs/userguide.xml
index 0ea8737524..c2c49bfd9f 100644
--- a/src/site/xdoc/docs/userguide.xml
+++ b/src/site/xdoc/docs/userguide.xml
@@ -343,25 +343,7 @@ axis2.xml file.</p>
 <p>Axis2 also provides a third distribution, the <a href="../download.cgi">
 source distribution</a>, which enables you to generate this .war
 file yourself.</p>
-<a id="docs" name="docs"></a>
-<h2>Axis2 Documentation Distribution Directory Hierarchy</h2>
-<p>The Documents distribution includes all Axis2 documentation
-including the xdcos and javadocs. It has the following
-structure:</p>
-<p><b>Code Listing 3: Axis2 Documents Distribution</b></p>
-<pre>
-docs
-      javadocs
-      xdocs
-
-LICENSE.txt
-README.txt
-release-notes.html
-</pre>
-<p>The javadocs directory includes all the standard <a href=
-"../api/index.html">API documentation</a> for the Axis2
-API, with other documentation (like this document) in the xdocs
-directory.</p>
+<!-- Documents Distribution section removed as obsolete -->
 <a name="clients" id="clients"></a>
 <h2>Axis2 and Clients</h2>
 <p>Now that explains how Axis2 behaves as part of a Web
diff --git a/src/site/xdoc/git.xml b/src/site/xdoc/git.xml
index 40d07fd16e..9fbc9be596 100644
--- a/src/site/xdoc/git.xml
+++ b/src/site/xdoc/git.xml
@@ -106,10 +106,10 @@
                         <tt>generate-resources</tt> phases, but fails to 
locate them if they
                         are generated during the 
<tt>generate-test-sources</tt> and
                         <tt>generate-test-resources</tt> phases. This is due 
to a limitation in Maven 2 (see
-                        <a 
href="http://jira.codehaus.org/browse/MECLIPSE-37";>MECLIPSE-37</a>
+                        <s><a 
href="http://jira.codehaus.org/browse/MECLIPSE-37";>MECLIPSE-37</a></s> 
<em>(Codehaus JIRA is no longer accessible)</em>
                         for more information). Executing the 
<tt>eclipse:eclipse</tt> goal after
                         the <tt>process-test-resources</tt> phase is also not 
enough because of
-                        <a 
href="http://jira.codehaus.org/browse/MDEP-259";>MDEP-259</a>. The
+                        <s><a 
href="http://jira.codehaus.org/browse/MDEP-259";>MDEP-259</a></s> <em>(Codehaus 
JIRA is no longer accessible)</em>. The
                         best is to execute it after the <tt>install</tt> 
phase. The <tt>skipTests</tt>
                         property can be used to skip the execution of the unit 
tests (<tt>maven.test.skip</tt>
                         is not appropriate here because it also skips some of 
the goals configured
diff --git a/src/site/xdoc/refLib.xml b/src/site/xdoc/refLib.xml
index ddeccc4860..8e1f367799 100644
--- a/src/site/xdoc/refLib.xml
+++ b/src/site/xdoc/refLib.xml
@@ -68,20 +68,20 @@ Java API for XML-based RPC (JAX-RPC)</a></p>
 "http://www.w3.org/TR/2005/REC-soap12-mtom-20050125/";>SOAP Message
 Transmission Optimization Mechanism</a></p>
 <p><b>Other Resources</b></p>
-<p><b><a href="http://java.sun.com/docs/books/jls/index.html";>The
+<p><b><a href="https://docs.oracle.com/javase/specs/";>The
 Java Language Specification</a></b><br />
 Written by the creators of the Java Programming Language, this
 online book is considered by many to be the bible for programming
-in Java. A must read.</p>
+in Java. A must read. <em>Note: OpenJDK documentation available at <a 
href="https://openjdk.org/groups/compiler/doc/";>OpenJDK Compiler 
Group</a></em></p>
 <p><b><a href=
-"http://java.sun.com/products/jdk/javadoc/index.html";>Javadoc</a></b><br />
+"https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html";>Javadoc</a></b><br
 />
 
 Javadoc is the automatic software documentation generator used by
 Java, since it was first released. All code written for this
-project must be documented using Javadoc conventions.</p>
-<p><b><a href=
+project must be documented using Javadoc conventions. <em>Available in all 
OpenJDK distributions.</em></p>
+<p><b><s><a href=
 "http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html";>The
-Java Code Conventions</a></b><br />
+Java Code Conventions</a></s></b> <em>(Sun link no longer accessible - see <a 
href="https://google.github.io/styleguide/javaguide.html";>Google Java Style 
Guide</a> for modern conventions)</em><br />
 This Sun document specifies the de-facto standard way of formatting
 Java code. All code written for this project must follow these
 conventions.</p>
diff --git a/src/site/xdoc/tools/eclipse/wsdl2java-plugin.xml 
b/src/site/xdoc/tools/eclipse/wsdl2java-plugin.xml
index 009635c87a..d7c884b667 100644
--- a/src/site/xdoc/tools/eclipse/wsdl2java-plugin.xml
+++ b/src/site/xdoc/tools/eclipse/wsdl2java-plugin.xml
@@ -144,7 +144,7 @@
             <li>Eclipse reference - <a href=
             "http://www.eclipse.org/";>http://www.eclipse.org/</a></li>
             <li>Custom Ant Tasks - <a href=
-            
"http://ant.apache.org/manual/develop.html";>http://ant.apache.org/manual/develop.html</a></li>
+            
"https://ant.apache.org/manual/develop.html";>https://ant.apache.org/manual/develop.html</a></li>
             </ul>
         </section>
     </body>


Reply via email to