From 106102745e97c65feb34af800f5043f44f74ae47 Mon Sep 17 00:00:00 2001
From: Benjamin De Vierno <54540257+bdevierno1@users.noreply.github.com>
Date: Fri, 7 Aug 2026 15:14:20 -0400
Subject: [PATCH] docs: modernize README

Convert the plain-text README into a structured Markdown README.md with
an about section, getting-started steps, a first-contribution guide,
contributing notes, and license info.
---
 README    |  1 -
 README.md | 75 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 75 insertions(+), 1 deletion(-)
 delete mode 100644 README
 create mode 100644 README.md

diff --git a/README b/README
deleted file mode 100644
index 980a0d5..0000000
--- a/README
+++ /dev/null
@@ -1 +0,0 @@
-Hello World!
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bf29c7b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,75 @@
+# Hello World 👋
+
+> The first repository every developer creates when learning [GitHub](https://github.com) — and the canonical example used throughout GitHub's own documentation.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](#license)
+[![Made with GitHub](https://img.shields.io/badge/made%20with-GitHub-181717?logo=github)](https://github.com)
+[![Good First Repo](https://img.shields.io/badge/good%20first-repo-brightgreen.svg)](#getting-started)
+
+---
+
+## 📖 About
+
+**Hello-World** is a minimal starter repository. It exists to demonstrate the
+core building blocks of working on GitHub: creating a repository, editing files,
+committing changes, opening branches, and collaborating through pull requests.
+
+If you are reading this while following a GitHub tutorial, you are in the right
+place — this project is intentionally tiny so you can focus on the *workflow*
+rather than the code.
+
+## ✨ What you'll learn
+
+- How a repository is structured
+- How to make and commit a change
+- How to create a branch
+- How to open and review a pull request
+- How Markdown renders a `README`
+
+## 🚀 Getting started
+
+Clone the repository to your machine:
+
+```bash
+git clone https://github.com/octocat/Hello-World.git
+cd Hello-World
+```
+
+Print the classic greeting:
+
+```bash
+cat README.md | head -n 1
+# => # Hello World 👋
+```
+
+## 🌱 Make your first contribution
+
+1. **Fork** this repository (top-right of the page).
+2. **Create a branch** for your change:
+   ```bash
+   git checkout -b my-first-change
+   ```
+3. **Commit** your edit with a clear message:
+   ```bash
+   git commit -am "Describe your change"
+   ```
+4. **Push** the branch and **open a pull request**:
+   ```bash
+   git push origin my-first-change
+   ```
+5. Wait for review, iterate on feedback, and celebrate when it merges. 🎉
+
+## 🤝 Contributing
+
+Contributions of every size are welcome — even fixing a single typo is a great
+first pull request. Please keep changes focused and describe *what* changed and
+*why* in your PR description.
+
+## 📄 License
+
+This project is released under the [MIT License](https://opensource.org/licenses/MIT).
+You are free to use, copy, modify, and distribute it.
+
+---
+
+<p align="center"><sub>Happy coding! Every expert was once a beginner. 🐙</sub></p>