# Post-Study Survey - Quick Start Guide

## 🚀 Get Started in 3 Steps

### Step 1: Setup (One-Time Only)

Navigate to this URL in your browser:
```
/scripts/setup_survey_tables.php
```

You'll see confirmation that the database tables were created.

---

### Step 2: Create Your First Survey

1. **Go to Studies** → Click **📋 Survey** button on any study
2. **Customize the questions** or keep the defaults:
   - "Were any terms unclear?"
   - "Which category was hardest to name?"
   - "Any missing items you expected?"
3. **Click "Create Survey"**

**That's it!** Your survey is now active.

---

### Step 3: View Results

After participants complete your study:

1. **Go to Reports & Analytics**
2. **Click "📋 Survey Results"** on your study
3. **View all responses** and export to CSV

---

## What Participants See

When participants complete your study:

1. ✓ **Completion checkmark** appears
2. 📋 **Survey questions** display
3. 💬 **They provide feedback** (all optional)
4. ✨ **Final thank you** message

Participants can skip the survey if they want.

---

## Key Features

✓ **3 default questions + 2 custom questions**
✓ **Enable/disable per study**
✓ **CSV export for analysis**
✓ **Automatic display on thank you page**
✓ **Response tracking with timestamps**

---

## Where to Find Everything

| Feature | Location |
|---------|----------|
| Create/Edit Survey | Studies → Survey button |
| View Results | Reports → Survey Results button |
| Survey Stats | Reports page (shows response count) |
| Export Data | Survey Results page → Export to CSV |

---

## Tips

💡 **Keep questions short** - 3-5 questions is ideal
💡 **Test it yourself** - Preview mode shows how it looks to participants
💡 **Export regularly** - Download CSV backups of your data
💡 **Read all responses** - Qualitative data reveals insights metrics can't

---

## Need More Details?

See **POST_STUDY_SURVEY_GUIDE.md** for:
- Detailed setup instructions
- Best practices
- Troubleshooting
- Technical details
- Database schema

---

**Questions?** Everything is set up and ready to use! Just run the setup script and start creating surveys.