Add README with CI badge

Author: srikanthbaride

README.md

@@ -1,2 +1,96 @@
-# Reinforcement Learning Fundamentals — Code
-This repo hosts chapter-wise companion code. Chapter 2 is complete and CI-tested.
+# Reinforcement Learning Fundamentals — Companion Code
+
+[![CI](https://github.com/srikanthbaride/Reinforcement-Learning-Fundamentals-Code/actions/workflows/python-tests.yml/badge.svg)](https://github.com/srikanthbaride/Reinforcement-Learning-Fundamentals-Code/actions)
+
+This repository hosts **chapter-wise companion code** for the book *Reinforcement Learning Fundamentals: From Theory to Practice*.  
+It provides clean, minimal, and well-tested implementations of key reinforcement learning concepts.
+
+---
+
+## 📂 Repository Structure
+
+```
+rl-fundamentals-code/
+├─ ch2_rl_formulation/          # Chapter 2: The RL Problem Formulation
+│  ├─ gridworld.py              # 4x4 GridWorld MDP
+│  ├─ evaluation.py             # Policy evaluation, q_from_v
+│  ├─ policies.py               # Greedy & ε-greedy policies
+│  ├─ examples/                 # Numeric examples + GridWorld demo
+│  └─ tests/                    # Pytest-based validation
+├─ ch3_multi_armed_bandits/     # Chapter 3: Multi-Armed Bandits (placeholder)
+│  └─ tests/
+├─ utils/                       # Shared helper utilities
+├─ .github/workflows/           # CI: runs PyTest on every push/PR
+├─ requirements.txt             # Global dependencies
+└─ README.md
+```
+
+---
+
+## 🚀 Getting Started
+
+Clone this repository:
+
+```bash
+git clone https://github.com/srikanthbaride/Reinforcement-Learning-Fundamentals-Code.git
+cd Reinforcement-Learning-Fundamentals-Code
+```
+
+Set up a virtual environment (recommended):
+
+```bash
+python -m venv .venv
+source .venv/bin/activate   # Linux/macOS
+.\.venv\Scriptsctivate    # Windows PowerShell
+```
+
+Install dependencies:
+
+```bash
+pip install -r requirements.txt
+```
+
+---
+
+## ✅ Running Tests
+
+To run all tests:
+
+```bash
+python -m pytest -q
+```
+
+To run only Chapter 2 tests:
+
+```bash
+python -m pytest -q ch2_rl_formulation/tests
+```
+
+---
+
+## 🧪 Examples
+
+Run numeric checks for Chapter 2:
+
+```bash
+python -m ch2_rl_formulation.examples.numeric_checks
+```
+
+Run the GridWorld demo:
+
+```bash
+python -m ch2_rl_formulation.examples.gridworld_demo
+```
+
+---
+
+## ⚙️ Continuous Integration
+
+- GitHub Actions (`.github/workflows/python-tests.yml`) automatically run tests for all chapters on every push and pull request.
+- This ensures correctness and reproducibility of the examples.
+
+---
+
+## 📖 License
+
+MIT License © 2025 — Srikanth Baride