docs(examples): rewrite traefik example for v3

Addresses Joxit#380, Joxit#396, and Joxit#419

Author: jnovack

examples/traefik/README.md

@@ -1,22 +1,75 @@
-# Traefik example
+# Single URL Docker Registry UI for Docker Swarm
 
-Host the docker registry ui behind [traefik](http://traefik.io) with Docker Swarm mode.
+Swarm-compliant UI with public registry PULLs and authenticated registry PUSHes with Traefik v3.
 
-## How to run
+## Features
 
-Open a terminal console and type
+* Unauthenticated PULLs
+* Authenticated PUSH/DELETEs
+* Single URL (registry and ui on the same domain)
+* Let's Encrypt enabled
+* Authenticated Traefik Dashboard
 
-```bash
-bash run-swarm.sh
+## Introduction
+
+This configuration is designed to be a "single-serving" quickstart for homelab or development environment.
+It is built to be modular enough to easily break apart for larger or more production environments for the
+more advanced scenarios.
+
+It serves both a container registry and Joxit's Docker-Registry-UI on the same URL over HTTPS that can be
+secured with certificates from Let's Encrypt.  The registry allows for public PULLs and authenticated PUSHes.
+
+Additionally, the **traefik** dashboard UI is published (although you do not need it during production) on
+port 8443 because [traefik hardcodes](https://doc.traefik.io/traefik/operations/api/#dashboard) the paths
+`/dashboard` and `/api`, plus it is just good practice to logically separate your administrative endpoints.
+
+## Prerequisites
+
+### `.env` File
+
+The `.env` file makes it easy to perform all the replacements necessary.
+
+[!TIP]
+You may opt to find and replace the variables in the yaml file rather than relying on environment variables.
+
+```shell
+DOMAIN=contoso.com
+# Leave blank if not using Let's Encrypt
+RESOLVER=letsencrypt
+# Email address for Let's Encrypt
+[email protected]
 ```
 
-## Authentication
+## Uppies
+
+```shell
+❯ docker stack deploy -c swarm.yml registry
+Creating network registry_frontend
+Creating service registry_traefik
+Creating service registry_redis
+Creating service registry_registry
+Creating service registry_ui
+Creating service registry_error-pages
+```
+
+### Accounts
+
+#### dashboard
+
+Traefik's dashboard account is:
+
+* Username: `admin`
+* Password: `hunter2`
+
+#### registry
 
-The registry is protected via __Basic authentication__ but feel free to use whatever you like.
-In this sample, credentials are: **admin / admin**.
+The registry account is:
 
-To generate a new password for basic auth, run the command: `htpasswd -nb username password`.
+* Username: `user`
+* Password: `hunter2`
 
 ## Contributors
 
-Thank you [@onizet](https://github.com/onizet) for this example.
+* [@jnovack](https://github.com/jnovack)
+* [@agahkarakuzu](https://github.com/agahkarakuzu)
+* [@onizet](https://github.com/onizet)