docker / docker/cli

Missing flags in man-page for docker build

Open
#4,024 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

area/builder area/builder/buildkit kind/docs kind/feature status/0-triage version/23.0
Dominant language
Go
Stars
6.1k
Forks
2.2k
Avg merge
1d 15h
Merged PRs (30d)
43

Description

Description

The man-page for docker build is incomplete. The --progress flag is not there. Perhaps there are more flags missing; I haven't made an extensive comparison. I recently needed to figure something, and found --progress in a Reddit post, however not in the man-page. I occasionally use the man-pages for docker, although they don't appear to be updated frequently (last commit was +2 years ago).

https://docs.docker.com/engine/reference/commandline/build/ Navigate here, and search for --progress. It's not there. Neither in man docker-build. It's not a build-kit specific flag.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the man docker-build output and the Docker build command-line documentation linked in the issue, then compare their documented flags with the current docker build options. Done means documenting --progress and any other missing build flags in the relevant man-page and confirming the references agree.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker
Domain
cli, documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.