docs icon indicating copy to clipboard operation
docs copied to clipboard

Add images for visualization of the concepts

Open Abhisheik-athi opened this issue 4 months ago • 1 comments

Is this a docs issue?

  • [x] My issue is about the documentation content or website

Type of issue

Other

Description

Add images for visualization of the concepts. I prefer to understand the concepts of container or images with respect to images that help me visualize them.

Location

https://docs.docker.com/get-started/docker-concepts/the-basics/what-is-a-container/

Suggestion

No response

Abhisheik-athi avatar Aug 17 '25 07:08 Abhisheik-athi

I just took a look at the documentation you mention and it does feel like a visualization or two would be helpful. Perhaps it would be something like this;

"The Problem", a.k.a., Before Containers

A diagram showing:

  • Three overlapping circles representing conflicting dependencies (Node, Python, PostgreSQL)
  • Question marks and warning symbols illustrating version conflicts
  • Different environments (dev machine, CI/CD, production) with mismatched versions

"The Solution", a.k.a., Container Architecture

A diagram showing three distinct boxes (containers) side-by-side, each labeled:

  • React Frontend (with Node logo)
  • Python API (with Python logo)
  • PostgreSQL DB (with database icon)

Each box showing it contains "App + Dependencies"...they would all sit on a single "Host Machine" base. Arrows pointing to key benefits, e.g., self-contained, isolated, independent, portable, with icons

"Containers vs VMs", a.k.a., Side-by-Side Comparison

A two-column diagram:

  • VM Column: Multiple stacked layers: Hardware → Hypervisor → Multiple full OS stacks → Apps. Perhaps labeled something like "Heavy - Full OS per app"
  • Container Column: Fewer layers: Hardware → Host OS → Container Runtime → Multiple thin containers...maybe labeled something like "Lightweight - Shared kernel"

Maybe "The Problem" and "The Solution" could be stacked or side-by-side to more easily show the comparison.

@Abhisheik-athi Is this what you were thinking?

ahopp avatar Oct 28 '25 20:10 ahopp