You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@james.apache.org by bt...@apache.org on 2026/08/26 08:08:19 UTC
(james-project) 07/07: [DOC] Link the james-site community section
This is an automated email from the ASF dual-hosted git repository.
chibenwa pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git
commit 1829b41f346f332a3f352c4f038fc9aacac075ca
Author: Benoit TELLIER <bt...@linagora.com>
AuthorDate: Mon Aug 24 11:32:44 2026 +0700
[DOC] Link the james-site community section
---
docs/README.adoc | 2 +-
docs/antora-playbook-local.yml | 5 +++++
docs/modules/ROOT/pages/index.adoc | 2 +-
docs/modules/development/pages/index.adoc | 2 +-
docs/modules/servers/partials/operate/logging.adoc | 2 +-
docs/modules/servers/partials/operate/metrics.adoc | 2 +-
docs/ui-overrides/partials/header-content.hbs | 2 +-
7 files changed, 11 insertions(+), 6 deletions(-)
diff --git a/docs/README.adoc b/docs/README.adoc
index 32985ff44f..36e5940e37 100644
--- a/docs/README.adoc
+++ b/docs/README.adoc
@@ -46,7 +46,7 @@ Go to `http://localhost` in your browser.
=== Build with the nix enviroment
-Enter the link:https://james.apache.org/contribute.html[james experimental
+Enter the link:https://james.apache.org/james-site/latest/contributing.html#_experimental_nix_support[james experimental
development shell] with `nix develop`
. Build the Antora content locally
diff --git a/docs/antora-playbook-local.yml b/docs/antora-playbook-local.yml
index 1373178ab1..4739650783 100644
--- a/docs/antora-playbook-local.yml
+++ b/docs/antora-playbook-local.yml
@@ -23,6 +23,11 @@ content:
# A value for a git repo located in the docs folder would be:
# start_path: ./
start_path: ./docs
+ # The community section lives in the james-site repository: needed to
+ # resolve the `james-site::` cross-component xrefs.
+ - url: https://github.com/apache/james-site.git
+ branches: master
+ start_path: docs
ui:
bundle:
url: https://gitlab.com/antora/antora-ui-default/-/jobs/artifacts/master/raw/build/ui-bundle.zip?job=bundle-stable
diff --git a/docs/modules/ROOT/pages/index.adoc b/docs/modules/ROOT/pages/index.adoc
index 5a8766ebe4..836c947552 100644
--- a/docs/modules/ROOT/pages/index.adoc
+++ b/docs/modules/ROOT/pages/index.adoc
@@ -21,4 +21,4 @@ This Reference Book is divided into the following Parts:
** A guide aimed at experienced developers, describing
how you can assemble your own specialized server.
-Please note that this Reference Documentation is a **living document**. It is subject to change. You are currently reading version {page-version}. If you find anything that is unclear, unfinished, or confusing, please do not hestiate to link:https://james.apache.org/contribute.html[lend us a hand].
+Please note that this Reference Documentation is a **living document**. It is subject to change. You are currently reading version {page-version}. If you find anything that is unclear, unfinished, or confusing, please do not hestiate to xref:james-site::contributing.adoc[lend us a hand].
diff --git a/docs/modules/development/pages/index.adoc b/docs/modules/development/pages/index.adoc
index 8017522d00..9b56baa8b4 100644
--- a/docs/modules/development/pages/index.adoc
+++ b/docs/modules/development/pages/index.adoc
@@ -3,7 +3,7 @@
This page aggregates common knowledge for contributing to Apache james servers.
-link:https://james.apache.org/contribute.html[Contribution guidelines] apply.
+xref:james-site::contributing.adoc[Contribution guidelines] apply.
xref:logging.adoc[This page] explains how *logging* should be done.
diff --git a/docs/modules/servers/partials/operate/logging.adoc b/docs/modules/servers/partials/operate/logging.adoc
index 0d21945b76..4247051da5 100644
--- a/docs/modules/servers/partials/operate/logging.adoc
+++ b/docs/modules/servers/partials/operate/logging.adoc
@@ -5,7 +5,7 @@ If you encounter some suspicious logs:
* If you have any doubt about the log being caused by a bug in James
source code, please reach us via the bug tracker, the user mailing list or our Gitter channel (see our
-http://james.apache.org/#second[community page])
+xref:james-site::index.adoc[community page])
* They can be due to insufficient performance from tier applications (eg
{backend-name} timeouts). In such case we advise you to conduct a close
review of performances at the tier level.
diff --git a/docs/modules/servers/partials/operate/metrics.adoc b/docs/modules/servers/partials/operate/metrics.adoc
index 4c8e105aa2..5f4ecaa1fa 100644
--- a/docs/modules/servers/partials/operate/metrics.adoc
+++ b/docs/modules/servers/partials/operate/metrics.adoc
@@ -174,6 +174,6 @@ link:https://github.com/apache/james-project/blob/3.7.x/server/apps/distributed-
If some metrics seem abnormally slow despite in depth database
performance tuning, feedback is appreciated as well on the bug tracker,
the user mailing list or our Gitter channel (see our
-http://james.apache.org/#second[community page]) . Any additional
+xref:james-site::index.adoc[community page]) . Any additional
details categorizing the slowness are appreciated as well (details of
the slow requests for instance).
diff --git a/docs/ui-overrides/partials/header-content.hbs b/docs/ui-overrides/partials/header-content.hbs
index 1f6034bd8e..24240d3465 100644
--- a/docs/ui-overrides/partials/header-content.hbs
+++ b/docs/ui-overrides/partials/header-content.hbs
@@ -28,7 +28,7 @@
<div class="navbar-item has-dropdown is-hoverable">
<a class="navbar-link" href="#">Community</a>
<div class="navbar-dropdown">
- <a class="navbar-item" href="https://james.apache.org/mail.html">Mailing lists</a>
+ <a class="navbar-item" href="https://james.apache.org/james-site/latest/mailing-lists.html">Mailing lists</a>
<a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
<a class="navbar-item" href="https://twitter.com/ApacheJames">
<span class="icon">
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org