Update readme

[saengel]

Some enhancements to the README.md file for enhanced context, readability and visibility for external devs.

[gitvelocity-reviewer]

📊 Code Quality Score: 1/100

3 × 0.1 (Nano ESF) = 0.3, floored to minimum of 1

Category	Score	Factors
🔭 Scope	1/20	Single README file, pure documentation, no logic or API changes
🏗️ Architecture	0/20	No architectural changes
⚙️ Implementation	0/20	No implementation code; pure prose documentation
⚠️ Risk	0/20	No operational risk; documentation-only change
✅ Quality	2/15	Well-structured documentation with clear sections, algorithm explanation, design guarantees, and use cases
🔒 Perf / Security	0/5	Not applicable for documentation change

Was this score accurate? 👍 Yes · 👎 No

_{Scored by GitVelocity · How are scores calculated?}

[yonadavGit]

nice summary example!

[gitvelocity-reviewer]

📊 Code Quality Score: 1/100

Base Score 4 × ESF 0.1 = 0.4, floored to minimum of 1

Category	Score	Factors
🔭 Scope	1/20	Single README.md file, pure documentation text expansion, no code or logic changes
🏗️ Architecture	0/20	No architectural changes; documentation only
⚙️ Implementation	0/20	No implementation code; pure prose writing
⚠️ Risk	1/20	Trivially reversible documentation update; minimal risk
✅ Quality	2/15	Well-structured and clear documentation with good organization, but no tests or code to validate
🔒 Perf / Security	0/5	Not applicable for documentation-only change

Was this score accurate? 👍 Yes · 👎 No

_{Scored by GitVelocity · How are scores calculated?}