From 2261346334d91029db80922c0432feff0b094b40 Mon Sep 17 00:00:00 2001
From: Vadim <129969897+vadcx@users.noreply.github.com>
Date: Thu, 27 Apr 2023 10:49:15 +0200
Subject: [PATCH] DockerHub-README.md: reword ambiguous command (#6080)

* DockerHub-README.md: reword ambiguous command

Being unfamiliar with the docker options, I thought the square brackets could be part of the command.

Instead, they refer to the sentence *after* the command, that is, they meant "optionally".

To remove the ambiguity, I put into onto different lines with an explanation.

* DockerHub-README.md: reword again, -v by default

- only leave the command with -v as an example
- grammar
- httpS link
---
 release/docker/DockerHub-README.md | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/release/docker/DockerHub-README.md b/release/docker/DockerHub-README.md
index d52f4d641..82f45b651 100644
--- a/release/docker/DockerHub-README.md
+++ b/release/docker/DockerHub-README.md
@@ -4,14 +4,16 @@ Containerized version of [mitmproxy](https://mitmproxy.org/): an interactive, SS
 
 ## Usage
 
+To launch the terminal user interface of mitmproxy:
+
 ```sh
-$ docker run --rm -it [-v ~/.mitmproxy:/home/mitmproxy/.mitmproxy] -p 8080:8080 mitmproxy/mitmproxy
-[terminal user interface of mitmproxy is launched...]
+$ docker run --rm -it -v ~/.mitmproxy:/home/mitmproxy/.mitmproxy -p 8080:8080 mitmproxy/mitmproxy
 ```
 
-The *volume mount* is optional: It's to store the generated CA certificates.
+Note: The `-v` for *volume mount* is optional. It allows to persist and reuse the generated CA certificates between runs, and for you to access them.
+Without it, a new root CA would be generated on each container restart.
 
-Once started, mitmproxy listens as a HTTP proxy on `localhost:8080`:
+Once started, mitmproxy listens as an HTTP proxy on `localhost:8080`:
 
 ```sh
 $ http_proxy=http://localhost:8080/ curl http://example.com/
@@ -46,7 +48,7 @@ Proxy server listening at http://*:8080
 ```
 
 If `~/.mitmproxy/mitmproxy-ca.pem` is present in the container, mitmproxy will assume uid and gid from the file owner.
-For further details, please consult the mitmproxy [documentation](http://docs.mitmproxy.org/en/stable/).
+For further details, please consult the mitmproxy [documentation](https://docs.mitmproxy.org/en/stable/).
 
 ## Tags