Update README.md

Author: StefanTheCode

README.md

@@ -1 +1,86 @@
-# PragmaticDotNetCodeRules
+# Pragmatic .NET Code Rules – Starter Kit
+
+> **Real material from the course — free for newsletter subscribers.**
+
+This starter kit contains **ready defaults** taken directly from the course  
+**Pragmatic .NET Code Rules**.
+
+It is designed to help you start (or clean up) a .NET project with:
+- consistent code style
+- centralized build rules
+- predictable SDK versions
+- a minimal CI quality gate
+
+No theory.  
+No frameworks.  
+Just **practical defaults that work**.
+
+---
+
+## 📦 What’s Inside
+
+- `.editorconfig`  
+  Pragmatic, industry-default code style rules
+
+- `Directory.Build.props`  
+  Centralized build & analyzer configuration
+
+- `global.json`  
+  Pinned .NET SDK for reproducible builds
+
+- CI Quality Gate (GitHub Actions)  
+  Prevents dirty code from reaching `main`
+
+- Visual Studio Clean Code Checklist  
+  Helps you apply the rules in minutes
+
+---
+
+## 🚀 How to Use This Kit
+
+1. Copy the files into the **root of your solution**
+2. Commit the changes
+3. Run **Code Cleanup** in Visual Studio
+4. Push — CI will enforce the rules automatically
+
+That’s it.
+
+⏱️ Setup time: **5–10 minutes**
+
+---
+
+## 🎓 About the Course
+
+This starter kit is **Module 01 material** from the course:
+
+**Pragmatic .NET Code Rules**
+
+The full course covers:
+- advanced EditorConfig usage
+- automated code cleanup
+- diagnostic severities & warnings as errors
+- static code analysis (StyleCop, SonarAnalyzer)
+- centralized build rules
+- architecture tests
+- CI quality gates
+- logging & observability
+- AI-assisted PR & dependency reviews
+
+---
+
+## 🔓 Free, for Now
+
+This material is currently **free for newsletter subscribers**.
+
+If you find it useful, you’ll get notified when:
+- new modules are released
+- the full course becomes available
+
+---
+
+## 👋 Final Note
+
+You can use this kit even if you never buy the course.  
+It’s meant to improve real projects, not just sell content.
+
+Happy coding 👋