# 🤝 Contributing to cloudwithshad

You found a bug? Have a better way to explain something? Built a story explainer? **We'd love your contribution.**

---

## 🚀 Quick start

1. **Fork** the repo
2. **Create a branch**: `git checkout -b fix/typo-in-week-2`
3. **Make your change**
4. **Commit**: `git commit -m "Fix typo in Week 2 Lab 3 step 4"`
5. **Push**: `git push origin fix/typo-in-week-2`
6. **Open a Pull Request** on GitHub

---

## ✅ What we welcome

- **Typo fixes** — small PRs are great
- **Clearer explanations** — if a concept is confusing in a lab, rewrite it
- **Bug fixes** — code samples that don't work, broken HTML, etc.
- **New story explainers** — single-file HTML stories with Ghanaian/African cultural analogies
- **Translations** — labs translated to French, Swahili, Twi, etc.
- **Updated screenshots** — when AWS changes their UI (and they do, constantly)

---

## ❌ What we'd rather not see

- **Massive rewrites** of existing materials without discussing first (open an issue!)
- **Style changes** that don't add educational value
- **New labs** that change the curriculum scope (talk to Shadrack first)

---

## 📐 Style guide

- **Tone**: direct, warm, occasionally cheeky. We talk like Shadrack — plain-spoken, never condescending.
- **Code blocks**: always tested. If it's in the repo, it must actually run.
- **HTML labs**: match the existing visual template (navy + cyan, sticky sidebar, callout boxes)
- **Cultural references**: lean into West African examples wherever they fit. Make the content feel like home.

---

## ✨ Recognition

Every accepted PR gets:
- A mention in [`community/README.md`](./README.md) Hall of Fame
- A LinkedIn shout-out from Shadrack
- Genuine gratitude

The best contributors get an invitation to help shape future cohorts.

---

⬅️ [Back to Community](./README.md)