Jbrejner/markdownfix

[jbrejner]

This pull request introduces improvements to documentation formatting, consistency, and clarity across several markdown files in the Docker tutorial. The changes focus on standardizing code blocks, enhancing readability, and aligning terminology usage, making the tutorial easier to follow for beginners.

Documentation formatting and linting:

• Added a .markdownlint.json configuration file to enforce consistent markdown style, including line length and allowed inline HTML elements (details, summary).
• Updated all code blocks in exercise files (labs/01-hello-world.md, labs/02-running-images.md, labs/03-deletion.md) to specify the language (e.g., bash) for improved syntax highlighting and consistency. [1] [2] [3] [4]

Clarity and readability improvements:

• Reformatted long sentences and lists in multiple files (CHEATSHEET.md, README.md, labs/00-getting-started.md, labs/01-hello-world.md, labs/02-running-images.md, labs/03-deletion.md) to use line breaks and clearer phrasing, making instructions and explanations easier to read. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11]
• Improved section headers and transitions in README.md to better guide users through the tutorial steps.

Terminology and instructional consistency:

• Standardized terminology explanations and command descriptions throughout the labs to ensure consistent understanding of Docker concepts for new users. [1] [2] [3]

These updates make the documentation more approachable and maintainable for future contributors.

[Copilot]

Pull Request Overview

This pull request introduces significant improvements to documentation formatting, consistency, and clarity across the Docker tutorial repository. The changes focus on standardizing markdown formatting with linting rules, improving code block syntax highlighting, and enhancing overall readability for beginners.

• Added markdown linting configuration to enforce consistent style guidelines
• Standardized all code blocks to include proper language specification for syntax highlighting
• Enhanced readability through improved line breaks, sentence structure, and terminology consistency

Reviewed Changes

Copilot reviewed 46 out of 46 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
.markdownlint.json	Adds markdown linting configuration with line length and HTML element rules
README.md	Improves structure and formatting with better headers and line breaks
CHEATSHEET.md	Enhances readability with proper formatting and source attribution
labs/* files	Standardizes code blocks with language tags and improves text formatting
trainer/* files	Fixes typos, improves formatting, and adds proper code block languages

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

Fixed the typo 'useles' to 'useless' which improves readability and professionalism of the documentation.

[Copilot]

The URL is malformed with HTML entities and missing closing angle bracket. Should be <domain>:<port>/hello/docker-is-awesome with proper formatting.

Suggested change

	_*Q: What do you see on <domain>:<port&gt/hello/docker-is-awesome ?*_
	_*Q: What do you see on <domain>:<port>/hello/docker-is-awesome?*_