# 🎯 Project Spec: DebugDeck — Solved Problems Wiki

## Overview
A community wiki where students document SOLUTIONS to common coding errors. Not "what is this error?" but "how did I fix it?"

**Target Users**: Beginning programmers
**Impact Goal**: 500+ error solutions documented
**Build Time**: Ongoing (add 1/day)

---

## Impact First

### Problem
- Students make the same errors over and over
- Stack Overflow is overwhelming for beginners
- Solutions are scattered

### Impact
- **Solutions**: 500+ documented
- **Time Saved**: For hundreds of students
- **Community**: Knowledge sharing

### Leadership
- Knowledge curation
- Community documentation
- Long-term maintenance

---

## Features

### MVP
1. **Error Database**: Common errors + solutions
2. **Search**: Find by error message
3. **Languages**: Python, JavaScript, Java, C++
4. **Categories**: Syntax, Runtime, Logic, Environment

### Version 2
1. **Contributions**: Community submissions
2. **Voting**: Best solutions rise
3. **Code Snippets**: Syntax highlighted
4. **Difficulty**: Beginner/Intermediate/Advanced

---

## Implementation

### Launch (Week 1)
- [ ] Create Notion or Obsidian database
- [ ] Document first 50 common errors
- [ ] Create simple web view (Obsidian Publish or similar)
- [ ] Share with CS department

### Growth (Ongoing)
- [ ] Add 1 solution per day
- [ ] Collect community contributions
- [ ] Get teacher认可

---

## Content Strategy

### Top 50 Errors to Document First

#### Python
- IndentationError: unexpected indent
- NameError: name 'x' is not defined
- TypeError: unsupported operand type
- IndexError: list index out of range
- ModuleNotFoundError: No module named 'x'
- SyntaxError: invalid syntax
- KeyError
- ValueError

#### JavaScript
- TypeError: undefined is not an object
- TypeError: Cannot read property 'x' of undefined
- SyntaxError: Unexpected token
- ReferenceError: x is not defined
- Error: CORS policy blocked

#### Java
- NullPointerException
- ArrayIndexOutOfBoundsException
- java.lang.NumberFormatException

#### General
- Git: merge conflicts
- Git: commit on detached HEAD
- Import errors
- Environment/path errors

---

## Metrics

| Metric | Target |
|--------|--------|
| Solutions | 500+ |
| Monthly Views | 2,000+ |
| Time Saved | 50+ hours of debugging |

---

## How to Demo

### Video
1. Show the problem (students stuck on same errors)
2. Show your solution (searchable wiki)
3. Show growth (50→500 solutions)
4. Show testimonials

### Essay Angle
- "I kept making the same error and couldn't remember the fix"
- "I started writing down fixes, then realized everyone needed this"
- "Now 500 solutions help 2,000+ students a month"
- "Small idea, big impact"

---

## Extension Ideas

1. **VS Code Extension**: Inline error help
2. **Discord Bot**: Error lookup in Discord
3. **API**: For other tools to use
4. **Print Version**: Handout for class

---

*Spec completed: 2026-04-28*

*Generated by Hermes Babu*