Revise README for clarity and structure

Updated README to enhance clarity and structure, including new sections and improved formatting.

Author: Pranav-MSK

README.md

@@ -1,91 +1,153 @@
-# 🎨 Issue-Ink 
+# 🎨 Issue-Ink  
 ## 🌍 The Global Rorschach Canvas
-A slow-motion collaborative art experiment powered entirely by GitHub.
-No servers. No database. Just Issues → Actions → SVG.
+
+A collaborative pixel canvas powered entirely by **GitHub Issues + GitHub Actions**.
+
+No backend.  
+No database.  
+Just commits.
 
 ---
 
 ## 🖼 Live Canvas
 
-![Canvas](map.svg)
+![Canvas](map.svg?ts=0)
 
 ---
 
-## 🎨 How To Paint
-1. Go to the **Issues** tab.
-2. Click **New Issue**.
-3. Use this exact format in the **title**:
+## ✍️ Paint a Pixel
+
+Anyone can contribute.
+
+1. Go to the **Issues** tab  
+2. Click **New Issue**  
+3. Use this exact format as the **title**:
 
 ```
 Paint [A5] #FF5733
 ```
 
-That’s it.
-If valid, your pixel will be painted automatically.
+Submit — and your pixel is painted automatically.
 
 ---
 
-## 📏 Valid Coordinates
+## ⚡ What Happens Next?
+
+When you open an issue:
+
+1. The title is parsed  
+2. A GitHub Action validates your input  
+3. The SVG canvas (`map.svg`) is updated  
+4. Game state is stored in `data/state.json`  
+5. Changes are committed  
+6. The canvas refreshes in this README  
+
+Everything happens in public.
+
+---
 
-Rows: **A–H**  
-Columns: **1–8**
+## 📏 Canvas Coordinates
+
+- Rows: **A–H**  
+- Columns: **1–8**
 
 Examples:
 
-- `Paint [A1] #FF0000`
-- `Paint [H8] #00FFAA`
+- `Paint [A1] #FF0000`  
+- `Paint [H8] #00FFAA`  
 
 ---
 
-## ⏳ Game Rules
+## ⏳ Rules
 
 - 🕒 **One paint per user every 24 hours**
-- 🔒 **Each painted tile is locked for 1 hour**
+- 🔒 **Each tile is locked for 1 hour after being painted**
 - Format must match exactly:
   `Paint [Coordinate] #HEXCODE`
-- Coordinate must be between **A1 and H8**
-- Color must be a valid **6-digit HEX code**
-- Invalid format → Issue labeled `Invalid`
+- Only valid **6-digit HEX colors** allowed
+- Invalid input → Issue labeled `Invalid`
 - Successful paint → Issue labeled `Completed`
-- Every action is permanently recorded in `data/state.json`
 
 ---
 
 ## 🧠 What Is This?
 
-The Global Rorschach Canvas is a shared 8×8 grid.
+This is not just a canvas.
+
+It’s a shared system where:
 
-Anyone can paint.
-Anyone can overwrite.
-No one controls the outcome.
+- Anyone can overwrite anything  
+- No one has permanent control  
+- Patterns emerge through conflict and cooperation  
 
-Patterns emerge.
-Conflicts form.
-Meaning is projected.
+Over time, the grid becomes:
 
-It’s not a picture.
+- A drawing  
+- A battleground  
+- A record of behavior  
 
-It’s behavior.
+It’s not about the pixels.
+
+It’s about what people do with them.
 
 ---
 
 ## ⚙️ How It Works
 
-- GitHub Issue = Input
-- GitHub Action = Validation + Mutation
-- SVG (`map.svg`) = Visual State
-- `data/state.json` = Persistent Game State
-- Git commit history = Permanent ledger
+The entire system runs inside this repository:
+
+```
+Issue → GitHub Action → SVG Update → Commit → README
+```
+
+### Components
+
+- `map.svg` → visual canvas  
+- `data/state.json` → persistent game state  
+- GitHub Actions → logic engine  
+- Git history → permanent ledger  
 
-Everything happens publicly.
+No external services are used.
 
 ---
 
-## 📜 Contributing
+## 📊 State Transparency
+
+All game data is publicly stored:
+
+- Last paint per user  
+- Tile locks  
+- Paint history  
+
+See: `data/state.json`
+
+---
+
+## 🚫 What This Is Not
+
+- Not a web app  
+- Not a real-time game  
+- Not centrally controlled  
+
+This is a **slow system by design**.
+
+---
+
+## 🤝 Contributing
+
+Want to improve the system?
+
+See [`CONTRIBUTING.md`](CONTRIBUTING.md)
+
+---
+
+## 🧩 Core Principle
+
+> Input → Mutation → Public Record
 
-See [`CONTRIBUTING.md`](CONTRIBUTING.md) for formatting rules and philosophy.
+That’s the entire engine.
 
 ---
 
-Built entirely with GitHub Actions.  
-Serverless. Deterministic. Transparent.
+Built entirely with GitHub.  
+Minimal by design.