Skip to content

docs: add concept diagrams to what-is-a-container page#24427

Open
mohithshuka wants to merge 4 commits intodocker:mainfrom
mohithshuka:fix/23256-add-concept-visuals
Open

docs: add concept diagrams to what-is-a-container page#24427
mohithshuka wants to merge 4 commits intodocker:mainfrom
mohithshuka:fix/23256-add-concept-visuals

Conversation

@mohithshuka
Copy link

Description

Added two visual diagrams to the "What is a container?" concepts page
to help users visualize the core concepts.

  • Added a container architecture diagram showing frontend, backend,
    and database containers running side by side, each with an isolated
    filesystem, all sharing the host OS kernel
  • Added a containers vs VMs comparison diagram highlighting that
    containers share the host kernel with no Guest OS overhead

Related issues or tickets

Closes #23256

Reviews

  • Technical review
  • Editorial review
  • Product review

Document that security_opt accepts multiple syntax forms:
- option=value
- option:value
- bare option (for booleans like no-new-privileges)

Add examples showing all three equivalent forms for no-new-privileges.

Fixes docker#23958
Closes docker#24138

- Added step-by-step verification using docker --version
- Added docker run hello-world to confirm end-to-end setup
- Added docker context ls to confirm desktop-linux context is active
Closes docker#23256

- Added container architecture diagram showing isolated containers
  sharing the host OS kernel
- Added containers vs VMs comparison diagram highlighting the
  absence of a Guest OS in containers
@netlify
Copy link

netlify bot commented Mar 19, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit a0a6742
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/69bc135dbd77460008c9cb30
😎 Deploy Preview https://deploy-preview-24427--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions bot added area/compose Relates to docker-compose.yml spec or docker-compose binary area/desktop Issue affects a desktop edition of Docker. E.g docker for mac area/get-started Relates to get started and onboarding docs labels Mar 19, 2026
Comment on lines +212 to +215
1. Open a terminal and check the Docker version:
```console
$ docker --version
```
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks like there are some indentation issues here; these need to be indented three spaces to align with step list item.

Suggested change
1. Open a terminal and check the Docker version:
```console
$ docker --version
```
1. Open a terminal and check the Docker version:
```console
$ docker --version

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the review, I will make this correct

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/compose Relates to docker-compose.yml spec or docker-compose binary area/desktop Issue affects a desktop edition of Docker. E.g docker for mac area/get-started Relates to get started and onboarding docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add images for visualization of the concepts

2 participants