bobbyiliev/introduction-to-docker-ebook

馃殌 Feedback: Add a few use cases and diagrams in chapter 1

Open

#2 opened on Oct 28, 2021

View on GitHubContributor guide
聽(4 comments)聽(0 reactions)聽(0 assignees)HTML聽(125 forks)github user discovery
enhancementgood first issue

Repository metrics

Stars
聽(593 stars)
PR merge metrics
聽(No merged PRs in 30d)

Description

Improve the initial Docker description by adding some use cases and diagrams as per the feedback received here:

Some feedback as someone completely new to Docker is that the definitions are good. However, you jump right into creating things and I would have preferred a few use cases and a few diagrams. I will go through your tutorials and they look easy enough.

Contributor guide

Research direction
Review the feedback comment at https://dev.to/billraymond/comment/1j907 to understand the suggested improvements, then create a few practical use cases and simple diagrams (e.g., using Mermaid or draw.io) to illustrate Docker concepts in the first chapter.
Tech stack
docker
Domain
documentation
Issue type
Documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
1
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
None
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
85