Optimized descriptions, README.md's and meta/main.yml's for portfolio and sphinx docs

roles/docker-mailu/README.md

@@ -1,8 +1,35 @@
-# Mailu Server Docker Role 🚀
+# Mailu
 
-This guide provides instructions for setting up, operating, and maintaining the [Mailu](https://mailu.io/) server Docker role.
+## Description
 
-## References 🔗
+Revolutionize your email communications with Mailu, a secure and flexible mail server solution that integrates comprehensive features like robust SMTP/IMAP support, advanced spam filtering, DKIM signing, and seamless webmail access. With its modern design and performance-oriented architecture, Mailu empowers you to manage digital correspondence with efficiency and reliability.
+
+## Overview
+
+Mailu is a complete mail server suite delivered as a Docker-based solution. It supports all essential email protocols, offers intuitive administration through a web interface, and integrates advanced security measures such as TLS encryption and virus scanning. Its modular architecture allows for scalable deployments and easy customization to suit diverse operational requirements.
+
+For further details on installation, configuration, and upgrades, please refer to the following documentation files in this directory:
+- [Installation.md](./Installation.md)
+- [Upgrade.md](./Upgrade.md)
+- [Spam_Issues.md](./Spam_Issues.md)
+- [User_Administration.md](./User_Administration.md)
+
+For more information about this role, visit the GitHub repositories:
+- [Mailu](https://github.com/kevinveenbirkenbach/cymais/tree/master/roles/docker-mailu)
+- [Mailu-OIDC](https://github.com/heviat/Mailu-OIDC)
+
+## Features
+
+- **Comprehensive Email Protocols:** Supports SMTP, IMAP, and POP3 for reliable email delivery and retrieval.
+- **Advanced Security:** Incorporates TLS encryption, DKIM, and SPF to secure your communications and prevent spoofing.
+- **Integrated Spam Filtering and Antivirus:** Offers robust tools for spam detection and virus scanning, ensuring your inboxes remain clean and secure.
+- **Customizable Webmail and Administration:** Provides a modern web interface for managing emails and administrative tasks with ease.
+- **Flexible Deployment:** Easily scale and customize using Docker Compose, with configurable settings for networking, storage, and external services.
+- **OIDC Support:** Optionally integrate with OpenID Connect for centralized authentication across your services.
+
+## Additional Resources
+
+- [Mailu Official Website](https://mailu.io/)
 - [Mailu compose setup guide](https://mailu.io/1.7/compose/setup.html)
 - [SysPass issue #1299](https://github.com/nuxsmin/sysPass/issues/1299)
 - [Mailu issue #1719](https://github.com/Mailu/Mailu/issues/1719)
@@ -11,19 +38,4 @@ This guide provides instructions for setting up, operating, and maintaining the
 - [Mailu issue #2827](https://github.com/Mailu/Mailu/issues/2827)
 - [Mailu GitHub repository](https://github.com/Mailu/Mailu)
 - [Plesk support article on RoundCube connection issue](https://support.plesk.com/hc/en-us/articles/115001264814-Unable-to-log-into-RoundCube-Connection-to-storage-server-failed)
-- [Gist by marienfressinaud](https://gist.github.com/marienfressinaud/f284a59b18aad395eb0de2d22836ae6b)
-
----
-
-For more information about this role, visit the GitHub repositories:
-- [Mailu](https://github.com/kevinveenbirkenbach/cymais/tree/master/roles/docker-mailu)
-- [Mailu-OIDC](https://github.com/heviat/Mailu-OIDC)
-
-### About this Role ✨
-
-This Mailu Docker role was developed by **[Kevin Veen-Birkenbach](https://veen.world)**.
-
-This `README.md` was optimized with the help of [ChatGPT](https://chat.openai.com)🚀 and this conversations: 
-
-- https://chat.openai.com/share/d1ad5ce7-3aa1-4a14-a959-63393b39374a
-- https://chatgpt.com/share/67a4bffb-9330-800f-aed5-715c6a8ced2f
+- [Gist by marienfressinaud](https://gist.github.com/marienfressinaud/f284a59b18aad395eb0de2d22836ae6b)

roles/docker-mailu/meta/main.yml

@@ -0,0 +1,22 @@
+---
+galaxy_info:
+  author: "Kevin Veen-Birkenbach"
+  description: "Revolutionize your email communications with Mailu, a secure and flexible mail server solution that integrates comprehensive features for managing digital correspondence reliably."
+  license: "CyMaIS NonCommercial License (CNCL)"
+  license_url: "https://s.veen.world/cncl"
+  company: |
+    Kevin Veen-Birkenbach
+    Consulting & Coaching Solutions
+    https://www.veen.world
+  galaxy_tags:
+    - mailu
+    - docker
+    - email
+    - mail server
+    - self-hosted
+  repository: "https://s.veen.world/cymais"
+  issue_tracker_url: "https://s.veen.world/cymaisissues"
+  documentation: "https://s.veen.world/cymais"
+  logo:
+    class: "fa-solid fa-envelope"
+dependencies: []