This is an automated email from the ASF dual-hosted git repository. Arsnael pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/james-project.git
commit 4117384a12f3d1c305ded38008bdc38e0d5e2709 Author: Felix Auringer <[email protected]> AuthorDate: Fri May 15 09:58:44 2026 +0200 refactor(docs): remove documentation for extendable server The extendable server is only referenced in very few places and is not included in the navigation. Furthermore, all of its pages include partials that are already included elsewhere and link to the postgres server in most cases. Additionally, all files that produce errors when building the docs are part of the documentation for the extendable server. --- docs/modules/concepts/pages/user/index.adoc | 2 +- docs/modules/servers/pages/basic/objectives.adoc | 2 +- .../servers/pages/extendable/architecture/index.adoc | 4 ---- .../servers/pages/extendable/configure/domainlist.adoc | 6 ------ .../servers/pages/extendable/configure/mailets.adoc | 6 ------ .../servers/pages/extendable/configure/matchers.adoc | 7 ------- .../configure/remote-delivery-error-handling.adoc | 8 -------- .../servers/pages/extendable/configure/smtp-hooks.adoc | 8 -------- .../servers/pages/extendable/configure/webadmin.adoc | 8 -------- .../servers/pages/extendable/customization/imap.adoc | 5 ----- .../servers/pages/extendable/customization/index.adoc | 5 ----- .../pages/extendable/customization/mail-processing.adoc | 5 ----- .../extendable/customization/mailbox-listeners.adoc | 5 ----- .../pages/extendable/customization/smtp-hooks.adoc | 5 ----- .../pages/extendable/customization/webadmin-routes.adoc | 5 ----- docs/modules/servers/pages/extendable/extending.adoc | 4 ---- docs/modules/servers/pages/extendable/index.adoc | 4 ---- docs/modules/servers/pages/extendable/variables.adoc | 4 ---- docs/modules/servers/pages/index.adoc | 17 ----------------- 19 files changed, 2 insertions(+), 108 deletions(-) diff --git a/docs/modules/concepts/pages/user/index.adoc b/docs/modules/concepts/pages/user/index.adoc index 82a3765dbc..26521682f5 100644 --- a/docs/modules/concepts/pages/user/index.adoc +++ b/docs/modules/concepts/pages/user/index.adoc @@ -41,7 +41,7 @@ Apache James offers Operators a range of servers for various use cases, includin * A xref:servers:basic/index.adoc[Basic Server] ideal for busy Operators who are interested in an easy-to-use self-hosting solution, but who may not have the time to gain deep expertise - * An xref:servers:extendable/index.adoc[Advanced Server] well-suited for Operators with + * A xref:servers:distributed/index.adoc[Distributed Server] well-suited for Operators with advanced skills and resources who are not daunted by getting their hands dirty with configurations or using built-in extensions diff --git a/docs/modules/servers/pages/basic/objectives.adoc b/docs/modules/servers/pages/basic/objectives.adoc index 7687f7358d..89f0b2b487 100644 --- a/docs/modules/servers/pages/basic/objectives.adoc +++ b/docs/modules/servers/pages/basic/objectives.adoc @@ -27,4 +27,4 @@ The default configuration of the Basic Server includes the following features: We have disabled all of the insecure communications and require SSL. If you have a specific requirement to use an insecure protocol, or if the above list does not satisfy your needs, then after having successfully set up this server you may want -to move on to the xref:servers:extendable/extending.adoc[Extendable Server]. +to move on to the xref:servers:distributed/extending.adoc[Distributed Server]. diff --git a/docs/modules/servers/pages/extendable/architecture/index.adoc b/docs/modules/servers/pages/extendable/architecture/index.adoc deleted file mode 100644 index 4b2efdf5a3..0000000000 --- a/docs/modules/servers/pages/extendable/architecture/index.adoc +++ /dev/null @@ -1,4 +0,0 @@ -= Extendable James Server — Architecture -:navtitle: Architecture - -TODO \ No newline at end of file diff --git a/docs/modules/servers/pages/extendable/configure/domainlist.adoc b/docs/modules/servers/pages/extendable/configure/domainlist.adoc deleted file mode 100644 index cec7712972..0000000000 --- a/docs/modules/servers/pages/extendable/configure/domainlist.adoc +++ /dev/null @@ -1,6 +0,0 @@ -= Extendable James Server — domainlist.xml -:navtitle: domainlist.xml - -:sample-configuration-prefix-url: https://github.com/apache/james-project/blob/postgresql/server/apps/postgres-app/sample-configuration - -include::partial$configure/domainlist.adoc[] \ No newline at end of file diff --git a/docs/modules/servers/pages/extendable/configure/mailets.adoc b/docs/modules/servers/pages/extendable/configure/mailets.adoc deleted file mode 100644 index 8ffc71fa01..0000000000 --- a/docs/modules/servers/pages/extendable/configure/mailets.adoc +++ /dev/null @@ -1,6 +0,0 @@ -= Extendable James Server — Mailets -:navtitle: Mailets - -:sample-configuration-prefix-url: https://github.com/apache/james-project/blob/postgresql/server/apps/postgres-app/sample-configuration -:server-name: Extendable James server -include::partial$configure/mailets.adoc[] \ No newline at end of file diff --git a/docs/modules/servers/pages/extendable/configure/matchers.adoc b/docs/modules/servers/pages/extendable/configure/matchers.adoc deleted file mode 100644 index d324a41250..0000000000 --- a/docs/modules/servers/pages/extendable/configure/matchers.adoc +++ /dev/null @@ -1,7 +0,0 @@ -= Extendable James Server — Matchers -:navtitle: Matchers - -:sample-configuration-prefix-url: https://github.com/apache/james-project/blob/postgresql/server/apps/postgres-app/sample-configuration -:pages-path: extendable -:server-name: Extendable James server -include::partial$configure/matchers.adoc[] \ No newline at end of file diff --git a/docs/modules/servers/pages/extendable/configure/remote-delivery-error-handling.adoc b/docs/modules/servers/pages/extendable/configure/remote-delivery-error-handling.adoc deleted file mode 100644 index 8ef8132481..0000000000 --- a/docs/modules/servers/pages/extendable/configure/remote-delivery-error-handling.adoc +++ /dev/null @@ -1,8 +0,0 @@ -= Extendable James Server — About RemoteDelivery error handling -:navtitle: About RemoteDelivery error handling - -:sample-configuration-prefix-url: https://github.com/apache/james-project/blob/postgresql/server/apps/postgres-app/sample-configuration -:pages-path: postgres -:server-name: Postgresql James server -:mailet-repository-path-prefix: postgres -include::partial$configure/remote-delivery-error-handling.adoc[] \ No newline at end of file diff --git a/docs/modules/servers/pages/extendable/configure/smtp-hooks.adoc b/docs/modules/servers/pages/extendable/configure/smtp-hooks.adoc deleted file mode 100644 index 5988be28cf..0000000000 --- a/docs/modules/servers/pages/extendable/configure/smtp-hooks.adoc +++ /dev/null @@ -1,8 +0,0 @@ -= Extendable James Server — SMTP Hooks -:navtitle: SMTP Hooks - -:sample-configuration-prefix-url: https://github.com/apache/james-project/blob/postgresql/server/apps/postgres-app/sample-configuration -:pages-path: extendable -:server-name: Extendable James server - -include::partial$configure/smtp-hooks.adoc[] \ No newline at end of file diff --git a/docs/modules/servers/pages/extendable/configure/webadmin.adoc b/docs/modules/servers/pages/extendable/configure/webadmin.adoc deleted file mode 100644 index 7e555607a2..0000000000 --- a/docs/modules/servers/pages/extendable/configure/webadmin.adoc +++ /dev/null @@ -1,8 +0,0 @@ -= Extendable James Server — webadmin.properties -:navtitle: webadmin.properties - -:sample-configuration-prefix-url: https://github.com/apache/james-project/blob/postgresql/server/apps/postgres-app/sample-configuration -:pages-path: extendable -:server-name: Extendable James server - -include::partial$configure/webadmin.adoc[] \ No newline at end of file diff --git a/docs/modules/servers/pages/extendable/customization/imap.adoc b/docs/modules/servers/pages/extendable/customization/imap.adoc deleted file mode 100644 index 387aba0a88..0000000000 --- a/docs/modules/servers/pages/extendable/customization/imap.adoc +++ /dev/null @@ -1,5 +0,0 @@ -= Custom IMAP processing -:navtitle: Custom IMAP processing -:pages-path: extendable - -include::partial$customization/imap.adoc[] \ No newline at end of file diff --git a/docs/modules/servers/pages/extendable/customization/index.adoc b/docs/modules/servers/pages/extendable/customization/index.adoc deleted file mode 100644 index c8c190e188..0000000000 --- a/docs/modules/servers/pages/extendable/customization/index.adoc +++ /dev/null @@ -1,5 +0,0 @@ -= Postgres James Mail Server — Extending behaviour -:navtitle: Extending behaviour -:pages-path: extendable - -include::partial$customization/index.adoc[] diff --git a/docs/modules/servers/pages/extendable/customization/mail-processing.adoc b/docs/modules/servers/pages/extendable/customization/mail-processing.adoc deleted file mode 100644 index 85dea6e1fd..0000000000 --- a/docs/modules/servers/pages/extendable/customization/mail-processing.adoc +++ /dev/null @@ -1,5 +0,0 @@ -= Custom mail processing components -:navtitle: Custom mail processing components -:pages-path: extendable - -include::partial$customization/mail-processing.adoc[] \ No newline at end of file diff --git a/docs/modules/servers/pages/extendable/customization/mailbox-listeners.adoc b/docs/modules/servers/pages/extendable/customization/mailbox-listeners.adoc deleted file mode 100644 index 9d4cb62738..0000000000 --- a/docs/modules/servers/pages/extendable/customization/mailbox-listeners.adoc +++ /dev/null @@ -1,5 +0,0 @@ -= Custom Mailbox Listeners -:navtitle: Custom Mailbox Listeners -:pages-path: extendable - -include::partial$customization/mailbox-listeners.adoc[] \ No newline at end of file diff --git a/docs/modules/servers/pages/extendable/customization/smtp-hooks.adoc b/docs/modules/servers/pages/extendable/customization/smtp-hooks.adoc deleted file mode 100644 index 1b84e6e9ba..0000000000 --- a/docs/modules/servers/pages/extendable/customization/smtp-hooks.adoc +++ /dev/null @@ -1,5 +0,0 @@ -= Custom SMTP hooks -:navtitle: Custom SMTP hooks -:pages-path: extendable - -include::partial$customization/smtp-hooks.adoc[] \ No newline at end of file diff --git a/docs/modules/servers/pages/extendable/customization/webadmin-routes.adoc b/docs/modules/servers/pages/extendable/customization/webadmin-routes.adoc deleted file mode 100644 index 94ea4c3239..0000000000 --- a/docs/modules/servers/pages/extendable/customization/webadmin-routes.adoc +++ /dev/null @@ -1,5 +0,0 @@ -= Custom WebAdmin routes -:navtitle: Custom WebAdmin routes -:pages-path: extendable - -include::partial$customization/webadmin-routes.adoc[] \ No newline at end of file diff --git a/docs/modules/servers/pages/extendable/extending.adoc b/docs/modules/servers/pages/extendable/extending.adoc deleted file mode 100644 index 1a49d1adbf..0000000000 --- a/docs/modules/servers/pages/extendable/extending.adoc +++ /dev/null @@ -1,4 +0,0 @@ -= Extendable James Mail Server — Extending behaviour -:navtitle: Extending behaviour - -This section can be read xref:extendable/customization/index.adoc[this page]. diff --git a/docs/modules/servers/pages/extendable/index.adoc b/docs/modules/servers/pages/extendable/index.adoc deleted file mode 100644 index f2f52d8c95..0000000000 --- a/docs/modules/servers/pages/extendable/index.adoc +++ /dev/null @@ -1,4 +0,0 @@ -= Extendable James Mail Server -:navtitle: Extendable James Application - -(TODO) \ No newline at end of file diff --git a/docs/modules/servers/pages/extendable/variables.adoc b/docs/modules/servers/pages/extendable/variables.adoc deleted file mode 100644 index c768ed2454..0000000000 --- a/docs/modules/servers/pages/extendable/variables.adoc +++ /dev/null @@ -1,4 +0,0 @@ -:sample-configuration-prefix-url: https://github.com/apache/james-project/blob/postgresql/server/apps/postgres-app/sample-configuration -:pages-path: postgres -:server-name: Postgresql James server -:mailet-repository-path-prefix: postgres \ No newline at end of file diff --git a/docs/modules/servers/pages/index.adoc b/docs/modules/servers/pages/index.adoc index 46235975ca..7470f86e38 100644 --- a/docs/modules/servers/pages/index.adoc +++ b/docs/modules/servers/pages/index.adoc @@ -14,7 +14,6 @@ The available James Servers are: * <<demo,James Demo Mail Server>> * <<basic,James Basic Mail Server>> - * <<extendable,James Extendable Mail Server>> * <<distributed,James Distributed Mail Server>> * <<postgres,James Postgres Mail Server>> * <<test,James Test Server>> @@ -53,22 +52,6 @@ production issues. -[#extendable] -== James Extendable Mail Server - -When your requirements start to get a little more serious, or you -start to feel adventurous and want to begin your own email adventure, -you can consider using the xref:extendable/index.adoc[*Extendable Server*]. - -This server is intended for experts who understand the consequences of -what they are doing. It provides extension mechanisms, configurations, -and integration points to customize its behavior. Unless you are processing -millions of emails on a daily basis (in which case you should consider the -<<distributed,Distributed Server>>), this server should cover just about -any email needs you may have. - - - [#distributed] == James Distributed Mail Server --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
