Merge ~valentinviennot/ubuntu-docker-images:update-mysql-readme into ~ubuntu-docker-images/ubuntu-docker-images/+git/mysql:edge

[Valentin Viennot]

Did some cleaning work and consistency against the last version of the Redis README.

[Sergio Durigan Junior (sergiodj)]

Thanks for the MP. There's just one very small nit, but otherwise everything is great. Let me know when you address it and I can merge your branch.

review: Needs Fixing

diff --git a/README.md b/README.md
index 490268e..46a6f2d 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
 MySQL is a fast, stable and true multi-user, multi-threaded SQL database
 server. SQL (Structured Query Language) is the most popular database query
 language in the world. The main goals of MySQL are speed, robustness and ease
-of use.
+of use. Read more on the [MySQL website](https://dev.mysql.com/doc/refman/8.0/en/).
 
 ## Tags
 
@@ -20,34 +20,26 @@ of use.
 ### Docker CLI
 
 ```sh
-$ docker network create mysql-net
-# Run the server
-$ docker run --name mysql-instance --network mysql-net --env MYSQL_ROOT_PASSWORD=My$seCret --detach squeakywheel/mysql:edge
-# Run the client
-$ docker run --interactive --tty --rm --network mysql-net squeakywheel/mysql:edge mysql -hmysql-instance -Uroot -p
-```
-
-The password will be asked and you can enter `My$seCret`. Now, you are logged in and can enjoy your new instance.
-
-Since containers are ephemeral you might be interested in persist data and not initialize a new database every time you launch a new container. To do that you can use docker volumes:
-
-```sh
-$ docker run --name mysql --volume /path/to/persisted/data:/var/lib/mysql --env MYSQL_RANDOM_ROOT_PASSWORD=yes squeakywheel/mysql:edge
+$ docker network create --driver bridge mysql-net
+$ docker run -d --name mysql-instance --network mysql-net -e TZ=Europe/London -e MYSQL_ROOT_PASSWORD=My:S3cr3t/ squeakywheel/mysql:edge
 ```
 
 #### Parameters
 
 | Parameter | Description |
 |---|---|
-| `-e TZ=UTC` | Timezone |
+| `-e TZ=UTC` | Timezone. |
 | `-e MYSQL_ROOT_PASSWORD=secret_for_root` | Set the password for the `root` user. This option is **mandatory** and **must not be empty**. |
 | `-e MYSQL_PASSWORD=secret` | Set the password for the `MYSQL_USER` user. |
-| `-e MYSQL_USER=john` | Create a new user with superuser privileges. This is used in conjunction with `MYSQL_PASSWORD` |
+| `-e MYSQL_USER=john` | Create a new user with superuser privileges. This is used in conjunction with `MYSQL_PASSWORD`. |
 | `-e MYSQL_DATABASE=db_test` | Set the name of the default database. |
 | `-e MYSQL_ALLOW_EMPTY_PASSWORD=yes` | Set up a blank password for the `root` user. **This is not recommended to be used in production, make sure you know what you are doing**. |
 | `-e MYSQL_RANDOM_ROOT_PASSWORD=yes` | Generate a random initial password for the `root` user using `pwgen`. It will be printed in the logs, search for `GENERATED ROOT PASSWORD`. |
 | `-e MYSQL_ONETIME_PASSWORD=yes` | Set `root` user as experide once initialization is complete, forcing a password change on first login. |
-| `-e MYSQL_INITSB_SKIP_TZINFO=yes` | Timezone data is automatically loaded via entrypoint script, set this variable to any non-empty value to disable it. | 
+| `-e MYSQL_INITSB_SKIP_TZINFO=yes` | Timezone data is automatically loaded via entrypoint script, set this variable to any non-empty value to disable it. |
+| `-p 30306:3306` | Expose MySQL server on `localhost:30306`. |
+| `-v /path/to/data:/var/lib/mysql` | Persist data instead of initializing a new database every time you launch a new container |
+| `-v /path/to/config/files/:/etc/mysql/mysql.conf.d/` | Pass your own [configuration files](https://dev.mysql.com/doc/refman/8.0/en/mysql-command-options.html) to the container. |
 
 #### Initialization Scripts
 
@@ -59,23 +51,20 @@ One can also add initialization scripts to their containers. This includes `*.sq
 
 All of this is done before the MySQL service is started. Keep in mind if your database directory is not empty (contains pre-existing database) they will be left untouched.
 
-#### Database Configuration
+#### Testing/Debugging
 
-You can pass your own configuration files to the container doing the following:
+In case you need to debug what it is happening with the container you can run `docker logs <name_of_the_container>`. But if you want to get access to an interactive shell run:
 
 ```sh
-$ docker run --name mysql --volume /path/to/mysql/config/files/:/etc/mysql/mysql.conf.d/ --env MYSQL_ROOT_PASSWORD=P@sSwd squeakywheel/mysql:edge
+$ docker exec -it <name_of_the_container> /bin/bash
 ```
 
-#### Debugging
-
-In case you need to debug what it is happening with the container you can run `docker logs <name_of_the_container>`. But if you want to get access to an interactive shell run:
+With this same image, you can launch an interactive container as a client to connect to your `mysql` server running in the first container.
 
 ```sh
-$ docker exec -it <name_of_the_container> /bin/bash
+$ docker run -it --rm --network mysql-net squeakywheel/mysql:edge mysql -hmysql-instance -uroot -p
 ```
-
-To see how to use the MySQL OCI image with `docker-compose` and `kubernetes` check the `examples/README.md` file.
+The password will be asked and you can enter `My:S3cr3t/`. Now, you are logged in and can enjoy your new instance.
 
 ## Deploy with Kubernetes