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

roles/docker-discourse/README.md

@@ -1,7 +1,35 @@
-# Ansible Role: Docker-Discourse
+# Discourse
 
-This Ansible role sets up Discourse, a popular open-source discussion platform, using Docker containers. It is designed to automate the deployment and configuration process of Discourse, making it easier to maintain and update.
+## Description
 
-## Credits 📝
-This README was generated with information provided in the Ansible role. For more detailed instructions and information, refer to the inline comments within the role files. Additional support and context for this role can be found in an [online chat discussion](https://chat.openai.com/share/fdbf9870-1f7e-491f-b4d2-357e6e8ad59c).
+Discourse is a popular open-source discussion platform designed to foster community engagement through modern, user-friendly features and robust moderation tools. It creates a dynamic space for discussions, offering seamless notifications and customizable interfaces to keep your community active and engaged.
 
+## Overview
+
+This role deploys Discourse using Docker, automating tasks such as container orchestration, service configuration, and routine administrative operations. It integrates key components like Redis and PostgreSQL, sets up domain routing with Nginx, and ensures streamlined updates for a reliable forum experience.
+
+For detailed usage and configuration, please refer to the following files in this directory:
+- [Administration.md](./Administration.md)
+
+## Features
+
+- **Modern Forum Experience:** Engage in interactive, real-time discussions with a responsive, mobile-friendly design.
+- **Robust Moderation Tools:** Benefit from comprehensive tools for content management and community moderation.
+- **Customizable Layouts & Themes:** Tailor your forum’s look and functionality to suit your community’s unique style.
+- **Scalable Architecture:** Utilize a Docker-based deployment that adapts easily to increasing traffic and community size.
+- **Extensive Plugin Support:** Enhance your forum with a wide range of plugins and integrations for additional functionality.
+
+## Additional Resources
+
+- [Discourse Official Website](https://www.discourse.org/)
+- [Discourse GitHub Repository](https://github.com/discourse/discourse_docker.git)
+- [Discourse Meta Forum](https://meta.discourse.org/)
+- [Discourse Documentation](https://meta.discourse.org/t/discourse-setup-guide/21966)
+
+## Credits
+
+Developed and maintained by **Kevin Veen-Birkenbach**.  
+Learn more at [veen.world](https://www.veen.world).
+
+Part of the [CyMaIS Project](https://github.com/kevinveenbirkenbach/cymais)  
+Licensed under [CyMaIS NonCommercial License (CNCL)](https://s.veen.world/cncl).

roles/docker-discourse/meta/main.yml

@@ -0,0 +1,22 @@
+---
+galaxy_info:
+  author: "Kevin Veen-Birkenbach"
+  description: "Discourse is a popular open-source discussion platform designed to foster community engagement with modern, user-friendly features and robust moderation tools."
+  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:
+    - discourse
+    - docker
+    - discussion
+    - forum
+    - open-source
+  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-comments"
+dependencies: []