Revamp Swarm example documentation and streamline deployment instructions

- Consolidated and simplified Swarm example README to focus on YAML header comments for documentation.
- Removed redundant and extended sections, replacing with concise steps for getting started.
- Standardized YAML headers across `easyhaproxy.yml`, `services.yml`, and `portainer.yml` with a clearer and more readable format.
- Enhanced user guidance for deployment, setup requirements, verification, and cleanup.

examples/docker/docker-compose-portainer.yml

@@ -1,7 +1,60 @@
+# ==============================================================================
+# EXAMPLE: Portainer Behind EasyHAProxy
+# ==============================================================================
+#
+# WHAT THIS DEMONSTRATES:
+# - Running Portainer (Docker management UI) behind EasyHAProxy
+# - Using external volumes and networks for shared infrastructure
+# - Real-world application example with Let's Encrypt
+# - HTTP to HTTPS redirect with Certbot
+#
+# REQUIREMENTS (run these first):
+# ```bash
+# # Create required volumes (idempotent)
 # docker volume create certs_certbot
 # docker volume create certs_haproxy
 # docker volume create portainer_data
+#
+# # Create shared network (idempotent)
 # docker network create easyhaproxy
+#
+# # Edit this file and change:
+# # - Line 18: EASYHAPROXY_CERTBOT_EMAIL to your email
+# # - Line 38: easyhaproxy.http.host to your real domain
+# ```
+#
+# HOW TO START:
+# ```bash
+# docker compose -f docker-compose-portainer.yml up -d
+# ```
+#
+# HOW TO VERIFY IT'S WORKING:
+# ```bash
+# # Check containers are running
+# docker compose -f docker-compose-portainer.yml ps
+# # Expected: Both easyhaproxy and portainer containers running
+#
+# # Access Portainer (replace with your domain or use /etc/hosts)
+# # First time: Create admin user
+# curl http://portainer.xpto.us
+# # OR with /etc/hosts: echo "127.0.0.1 portainer.xpto.us" | sudo tee -a /etc/hosts
+#
+# # View HAProxy stats
+# # URL: http://localhost:1936
+# # Username: admin
+# # Password: password
+# ```
+#
+# CLEAN UP:
+# ```bash
+# docker compose -f docker-compose-portainer.yml down
+# # To also remove volumes:
+# # docker compose -f docker-compose-portainer.yml down -v
+# # docker volume rm certs_certbot certs_haproxy portainer_data
+# # docker network rm easyhaproxy
+# ```
+#
+# ==============================================================================
 
 
 services: