# GitHub Discussions Setup Guide

## Recommended Discussion Categories

Once you enable GitHub Discussions, create these categories:

### 1. 📢 Announcements
- **Format:** Announcement
- **Description:** Official announcements from the TealTiger team
- **Who can post:** Maintainers only
- **Use for:** Release announcements, major updates, important news

### 2. 💬 General
- **Format:** Open-ended discussion
- **Description:** General discussions about TealTiger
- **Use for:** Community chat, introductions, off-topic discussions

### 3. 💡 Ideas
- **Format:** Open-ended discussion
- **Description:** Share and discuss ideas for TealTiger
- **Template:** Use `.github/DISCUSSION_TEMPLATE/ideas.yml`
- **Use for:** Feature brainstorming, improvement suggestions

### 4. ❓ Q&A
- **Format:** Question/Answer
- **Description:** Ask questions and get help from the community
- **Template:** Use `.github/DISCUSSION_TEMPLATE/q-and-a.yml`
- **Use for:** How-to questions, troubleshooting, best practices

### 5. 🎉 Show and Tell
- **Format:** Open-ended discussion
- **Description:** Show off what you've built with TealTiger
- **Template:** Use `.github/DISCUSSION_TEMPLATE/show-and-tell.yml`
- **Use for:** Project showcases, demos, success stories

### 6. 🔧 Development
- **Format:** Open-ended discussion
- **Description:** Discussions about TealTiger development
- **Use for:** Architecture discussions, contribution planning, technical deep-dives

### 7. 📚 Tutorials & Guides
- **Format:** Open-ended discussion
- **Description:** Community-created tutorials and guides
- **Use for:** Sharing tutorials, guides, tips and tricks

## How to Enable Discussions

1. Go to your repository: https://github.com/agentguard-ai/tealtiger
2. Click **Settings**
3. Scroll down to **Features**
4. Check the box for **Discussions**
5. Click **Set up discussions**

## Creating Categories

1. Go to **Discussions** tab
2. Click the **⚙️** icon (Categories settings)
3. Click **New category**
4. Fill in:
   - **Category name**
   - **Description**
   - **Discussion format** (Open-ended, Q&A, or Announcement)
5. Click **Create**

## Sample Discussions to Start

### Discussion 1: Welcome to TealTiger Discussions! 🎉

**Category:** Announcements

**Content:**
```markdown
# Welcome to TealTiger Discussions! 🎉

We're excited to launch GitHub Discussions for the TealTiger community!

## What are Discussions?

Discussions is a place for our community to:
- 💬 Ask questions and get help
- 💡 Share ideas and feedback
- 🎉 Show off what you've built
- 🤝 Connect with other developers

## How to Get Started

1. **Introduce yourself** in the General category
2. **Ask questions** in Q&A
3. **Share your projects** in Show and Tell
4. **Suggest features** in Ideas

## Community Guidelines

- Be respectful and inclusive
- Stay on topic
- Help others when you can
- Have fun! 🚀

Looking forward to building this community together!

— The TealTiger Team
```

---

### Discussion 2: Introduce Yourself! 👋

**Category:** General

**Content:**
```markdown
# Introduce Yourself! 👋

Welcome to the TealTiger community! We'd love to get to know you.

Share a bit about yourself:
- 👤 What's your name?
- 💼 What do you do?
- 🤖 What are you building with AI?
- 🎯 What brought you to TealTiger?
- 🌍 Where are you from?

Looking forward to meeting everyone!
```

---

### Discussion 3: What features would you like to see?

**Category:** Ideas

**Content:**
```markdown
# What features would you like to see in TealTiger?

We're always looking to improve TealTiger based on your needs!

**Current features:**
- 🛡️ Security guardrails (PII, prompt injection, content moderation)
- 💰 Cost tracking and budgets
- 🔌 OpenAI, Anthropic, and Azure OpenAI support

**What's missing?**

Share your ideas:
- What features would make TealTiger more useful for you?
- What AI providers should we support next?
- What guardrails would you like to see?
- What would improve your developer experience?

Vote on ideas you like with 👍 reactions!
```

---

### Discussion 4: Share Your TealTiger Projects!

**Category:** Show and Tell

**Content:**
```markdown
# Share Your TealTiger Projects! 🚀

We'd love to see what you're building with TealTiger!

**Share:**
- 📝 Project description
- 🔗 Links (GitHub, demo, website)
- 📸 Screenshots or videos
- 💡 What TealTiger features you're using
- 🎓 What you learned

Don't be shy — we want to celebrate your work! 🎉
```

---

### Discussion 5: Best Practices for AI Security

**Category:** Development

**Content:**
```markdown
# Best Practices for AI Security 🔒

Let's discuss best practices for securing AI applications!

**Topics to discuss:**
- What security measures do you implement?
- How do you handle PII in AI applications?
- What are common security pitfalls?
- How do you test security guardrails?
- What compliance requirements do you need to meet?

Share your experiences and learn from others!
```

---

## Pinning Important Discussions

Pin these discussions to the top:
1. Welcome announcement
2. Introduce yourself thread
3. Feature requests thread

To pin a discussion:
1. Open the discussion
2. Click the **⋯** menu
3. Select **Pin discussion**

## Moderation Tips

- Respond to questions promptly
- Mark helpful answers in Q&A discussions
- Encourage community participation
- Move off-topic discussions to appropriate categories
- Lock resolved discussions to keep things organized

## Engagement Ideas

- Weekly "Show and Tell" threads
- Monthly feature voting
- Community spotlight posts
- Tutorial sharing
- Office hours discussions
