Optimized .mds and meta/main.yml for system roles

roles/system-maintenance-lock/README.md

@@ -1,10 +1,25 @@
-# Role: System-Maintenance-Lock
+# System Maintenance Lock
+
+## Description
+
+This role provides a locking mechanism to ensure that critical services are not interrupted during maintenance activities such as updates, backups, or patch applications. It waits for specified services to stop and prevents conflicting operations.
 
 ## Overview
-The `system-maintenance-lock` role is a critical part of maintaining the integrity and performance of a system. It ensures that specific services are not interrupted or conflicted with by other system processes. This role is particularly vital during system updates, backups, or other maintenance activities where conflicting processes could cause issues.
 
-## Usage
-This role is used in scenarios where system stability and integrity are paramount, such as during system upgrades, backup processes, or when applying critical patches.
+The role performs the following:
+- Blocks execution until specified services have stopped.
+- Implements retry logic with a configurable timeout.
+- Ensures that maintenance tasks are executed only when the system is in a safe state.
 
-## Created with AI
+## Purpose
+
+The primary purpose of this role is to safeguard system stability during maintenance by preventing conflicts with running services. It ensures that maintenance operations proceed only when the environment is ready.
+
+## Features
+
+- **Service Locking:** Blocks maintenance tasks until critical services are stopped.
+- **Timeout and Retry Logic:** Configurable wait times and maximum attempts.
+- **Conflict Avoidance:** Prevents interference between maintenance operations and running services.
+
+## Credits
 Created with ChatGPT. Conversation is [here](https://chat.openai.com/share/a886b86b-8de6-4eca-9fba-e36c9f20d536) available.

roles/system-maintenance-lock/meta/main.yml

@@ -0,0 +1,24 @@
+---
+galaxy_info:
+  author: "Kevin Veen-Birkenbach"
+  description: "Ensures system integrity during maintenance activities by blocking execution until critical services have stopped, using a locking mechanism with timeout and retry logic."
+  license: "CyMaIS NonCommercial License (CNCL)"
+  license_url: "https://s.veen.world/cncl"
+  company: |
+    Kevin Veen-Birkenbach
+    Consulting & Coaching Solutions
+    https://www.veen.world
+  min_ansible_version: "2.9"
+  platforms:
+    - name: Linux
+      versions:
+        - all
+  galaxy_tags:
+    - maintenance
+    - lock
+    - system
+    - administration
+  repository: "https://s.veen.world/cymais"
+  issue_tracker_url: "https://s.veen.world/cymaisissues"
+  documentation: "https://s.veen.world/cymais"
+dependencies: []