Lack of detail in docker-compose build documentation

[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.