diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..627e8dc
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,91 @@
+# Contributing to AspNetCore Diagnostic Scenarios 🚀
+
+Welcome to the AspNetCore Diagnostic Scenarios repository! Your contributions can help make troubleshooting and diagnostics in ASP.NET Core a lot more fun and efficient. Here's how you can be part of this exciting journey. 😃
+
+## 🛠️ Submitting Contributions
+
+To contribute to this project, follow these steps:
+
+### 1. 🔍 Choose or Create an Issue
+
+- Start by checking out the existing issues. See if there's something you're interested in or create a new issue with your brilliant idea! 🌟
+
+### 2. 🍴 Fork the Repository
+
+- Get started by forking the primary repository. It's like having your playground! 🏞️
+
+### 3. 📥 Clone Your Forked Repository
+
+- Clone your forked repository to your local development environment using the following command:
+
+```bash
+git clone https://github.com/your-username/AspNetCoreDiagnosticScenarios.git
+```
+
+### 4. 🆙 Set Up the Upstream Remote
+
+- Keep in touch with the main project by adding it as the upstream remote:
+
+```bash
+cd AspNetCoreDiagnosticScenarios
+git remote add upstream https://github.com/davidfowl/AspNetCoreDiagnosticScenarios
+git remote -v
+```
+
+### 5. 🌿 Create a New Branch
+
+- Create a new branch and give it a creative name related to the issue you're tackling. 🌈
+
+```bash
+git checkout -b my-awesome-contribution
+```
+
+## ✨ Working on Your Contribution
+
+With your development environment set up and a dedicated branch, you can start working on your amazing contribution!
+
+### 6. 🛠️ Make Changes
+
+- Implement the necessary changes, such as code additions, enhancements, or bug fixes. Make your contribution as exciting as a rollercoaster ride! 🎢
+
+### 7. 📝 Commit Your Changes
+
+- Commit your changes with fun and descriptive commit messages that tell the story of your journey in this codebase. Make it emoji-tastic! 🚀
+
+```bash
+git commit -m "✨ Added a magical new feature"
+```
+
+### 8. 🚀 Push Your Changes
+
+- Push your committed changes to your remote repository on GitHub:
+
+```bash
+git push origin my-awesome-contribution
+```
+
+### 9. 🎉 Create a Pull Request
+
+- Visit your repository on GitHub and click the "New Pull Request" button to share your contributions with the main project. Make it sound like a big reveal! 🎆
+
+### 10. 🧐 Await Review
+
+- Your pull request will go through a thrilling review process. Project maintainers and contributors will provide feedback. Be ready for the applause or encore requests! 🎵
+
+## 🎉 Community Engagement
+
+While contributing, let's keep the fun going with these activities:
+
+### 11. 🗣 Join Discussions
+
+- Get involved in discussions about AspNetCore Diagnostic Scenarios. Share your excitement and ideas, and collaborate with others to create a carnival of innovation! 🎪
+
+### 12. 💡 Share Ideas
+
+- If you've got creative and wild ideas for improving diagnostics, don't hold back. Open issues and let the brainstorming begin! 🧠
+
+## 🙌 Acknowledgment
+
+We appreciate your energy and enthusiasm for making diagnostics in ASP.NET Core more exciting and efficient! If you have questions or need a dose of fun, contact the project maintainers.
+
+Thank you for your valuable contributions, and let's keep the fun and excitement rolling in AspNetCore Diagnostic Scenarios! 🌟🚀🎉