Skip to content

Lack of detail in docker-compose build documentation #21487

Open
@nicolas-goyon

Description

@nicolas-goyon

Is this a docs issue?

  • My issue is about the documentation content or website

Type of issue

I can't find what I'm looking for

Description

On the Docker Compose build page, there are several options with brief descriptions, but they lack detailed explanations and examples. It would be beneficial to include information on how each option works, how to use them, and their impact on the outputs. For example, explaining how the "build with dependencies" option affects the output would be very helpful. As a beginner with Docker Compose, I rely heavily on the official documentation, but the absence of examples and detailed information makes it difficult to understand how things work.

Location

https://docs.docker.com/reference/cli/docker/compose/build/

Suggestion

Add :

  • Examples of some docker-compose commands with options and their output with the base file
  • Add a couple of demo for heavy duty docker-compose files (a good amount of dependencies or complexity) to help people that try to scale their project in complexity.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area/composeRelates to docker-compose.yml spec or docker-compose binary

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions