From 19f34c61b9a0cd856b13898229dcfa6424e7537f Mon Sep 17 00:00:00 2001
From: pp-r <64266134+pp-r@users.noreply.github.com>
Date: Tue, 4 Oct 2022 15:39:12 +0200
Subject: [PATCH] Create app_mailman3.md

---
 .../10.docs/mailman3/app_mailman3.md          | 72 +++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 pages/04.applications/10.docs/mailman3/app_mailman3.md

diff --git a/pages/04.applications/10.docs/mailman3/app_mailman3.md b/pages/04.applications/10.docs/mailman3/app_mailman3.md
new file mode 100644
index 00000000..61b940f9
--- /dev/null
+++ b/pages/04.applications/10.docs/mailman3/app_mailman3.md
@@ -0,0 +1,72 @@
+---
+title: Mailman3
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_mailman3'
+---
+
+[![Installer Mailman3 with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=mailman3) [![Integration level](https://dash.yunohost.org/integration/mailman3.svg)](https://dash.yunohost.org/appci/app/mailman3)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Mailman3* is an electronic mailing lists manager.
+
+### Screenshots
+
+![Screenshot of Mailman3](./doc/screenshots/screenshot1.webp)
+
+### Disclaimers / important information
+
+* Any known limitations, constrains or stuff not working, such as (but not limited to):
+    * requiring a full dedicated domain
+
+* Other infos that people should be aware of, such as:
+    * No LDAP support yet (apparently under development)
+    * Users can also just sign up themselves to manage details
+    * Users can use mailing lists without signing up?
+
+Classical admin is available on the page: https://myyunohost.org/
+
+Django admin on: https://myyunohost.org/admin/
+
+### General Configuration
+
+Mailman 3 or "The Mailman Suite" is made up of 5 moving parts. See the following documentation for more:
+
+> http://docs.mailman3.org/en/latest/index.html#the-mailman-suite
+
+On your YunoHost, all the configuration files you need to worry about are in:
+
+* `/etc/mailman3/`
+* `/usr/share/mailman3-web/`
+
+The services you need to manage can be checked with:
+
+* `systemctl status mailman3`
+* `systemctl status mailman3-web`
+
+It is important to note that this package makes use of the [mailman3-full](http://docs.mailman3.org/en/latest/prodsetup.html#distribution-packages) Debian package contained in the Debian Stretch backports repository. The default installation assumes the use of a SQLite3 database but the installation script overrides this and uses a PostgreSQL database instead.
+
+Finally, you also configure things through the Django web admin available at `/admin/`.
+
+### Limitations
+
+* Migrating from Mailman 2.X is not officially supported, sorry. However, there is a manual and
+  which details an experimental process. Please see [the documentation](https://docs.mailman3.org/en/latest/migration.html).
+
+* Mailman3 must be configured to use a root domain (https://myyunohost.org and not https://myyunohost.org/mailman3).
+
+* You must have a HTTPS certificate installed on the root domain.
+
+* There may be only one installation per YunoHost.
+
+## Useful links
+
++ Website: [list.org](https://www.list.org/)
++ Demonstration: [Demo](https://lists.mailman3.org/mailman3/lists/)
++ Application software repository: [github.com - YunoHost-Apps/mailman3](https://github.com/YunoHost-Apps/mailman3_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/mailman3/issues](https://github.com/YunoHost-Apps/mailman3_ynh/issues)