Prefer long flags in quick start example

[rootulp]

--detach is clearer (to a new Docker user) than -d. Similarly --volume is clearer than -v.

Motivation: https://changelog.com/posts/use-long-flags-when-scripting
Referred to: https://docs.docker.com/engine/reference/commandline/run/

[codecov]

Codecov Report

Merging #1029 (2da3edc) into main (7221704) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main    #1029   +/-   ##
=======================================
  Coverage   59.63%   59.63%           
=======================================
  Files          22       22           
  Lines        1412     1412           
=======================================
  Hits          842      842           
  Misses        500      500           
  Partials       70       70           

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 7221704...2da3edc. Read the comment docs.

[piksel]

Agreed. It's clearer what every argument is doing, and if you already know what they do you probably also know the short hands (or you look them up if you care enough about make your commands shorter 😁)

[zoispag]

I disagree here. All the docker examples I was finding and following on the internet when I was learning docker were ALWAYS using -d, -p, -v, -e, etc.
Even now, experienced in Docker, --detach reads funny and is unusual to see it, imho.

[piksel]

@zoispag Indeed. That's probably why they were used in the docs in the first place. I think the main problem is with people who just copy commands from the docs and try to modify them to suite their needs.
The whole command can be fairly opaque to someone who don't know what flags take an argument etc.
Usually, -v maps to --verbose for example, which doesn't take an argument. 🤷‍♀️

[rootulp]

Usually, -v maps to --verbose for example, which doesn't take an argument. 🤷‍♀️

Agreed. I was similarly confused by this naming conflict. I think the longer format flags remove the risk of confusion.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.