# 👥 NOFX Community

Welcome to the NOFX community! This section contains everything you need to contribute and participate.

---

## 📢 Important Announcement

**🚀 New PR Management System Coming Soon!**

We're introducing a new PR management system to improve code quality and make contributing easier!

**📖 Read:** [Migration Announcement](MIGRATION_ANNOUNCEMENT.md) | [迁移公告（中文）](MIGRATION_ANNOUNCEMENT.zh-CN.md)

**Timeline:** 4-week gradual rollout starting soon

**For existing PRs:** Don't worry! Your PRs will not be blocked by new rules.

---

## 🤝 How to Contribute

### Getting Started

1. **Read the Guides**
   - [Contributing Guide](../../CONTRIBUTING.md) - Complete contribution workflow
   - [Code of Conduct](../../CODE_OF_CONDUCT.md) - Community standards
   - [Security Policy](../../SECURITY.md) - Report vulnerabilities

2. **Find Something to Work On**
   - Browse [GitHub Issues](https://github.com/NoFxAiOS/nofx/issues)
   - Look for `good first issue` label
   - Check out [bounty tasks](#-bounty-program)

3. **Join the Community**
   - 💬 [Telegram Developer Community](https://t.me/nofx_dev_community)
   - 🐦 [Twitter @nofx_official](https://x.com/nofx_official)
   - 🐙 [GitHub Discussions](https://github.com/NoFxAiOS/nofx/discussions)

---

## 💰 Bounty Program

### Active Bounties

NOFX offers bounties for valuable contributions:

| Category | Reward Range | Examples |
|----------|--------------|----------|
| 🥇 Major Features | $500-1000 | Exchange integration, core architecture |
| 🥈 Medium Features | $200-500 | WebSocket support, new AI models |
| 🥉 Small Features | $50-200 | Bug fixes, UI improvements, documentation |

### How to Claim Bounties

**📖 Complete Guide:** [bounty-guide.md](bounty-guide.md)

**Quick Steps:**
1. Find issue tagged `[BOUNTY]`
2. Comment with your proposal
3. Wait for approval
4. Work on the task
5. Submit PR with demo
6. Get paid after merge!

### Current Bounty Tasks

| Task | Reward | Difficulty | Status |
|------|--------|------------|--------|
| [Hyperliquid Integration](bounty-hyperliquid.md) | TBD | Hard | 🟡 Open |
| [Aster DEX Integration](bounty-aster.md) | TBD | Medium | ✅ Completed |

---

## 🏆 Recognition

### Ways to Get Recognized

**Contributor Levels:**
- 🌟 **Active Contributor** - Submit quality PRs
- ⭐ **Trusted Contributor** - 3+ merged PRs, given review rights
- 💎 **Core Team** - Top contributors, invited by maintainers

**Benefits:**
- Listed in README and release notes
- Direct access to maintainer discussions
- Priority support for your issues
- Invitation to private roadmap planning

### Hall of Fame

**Top Contributors:**
- Coming soon! Be the first! 🚀

---

## 📋 Contribution Types

### Code Contributions
- New exchange integrations
- AI model adapters
- Bug fixes and improvements
- Performance optimizations

**Required:**
- ✅ Code compiles and runs
- ✅ Follows code style guidelines
- ✅ Includes basic tests (preferred)
- ✅ Updates documentation if needed

### Documentation
- Tutorial writing
- Translation (中文, Русский, Українська)
- FAQ updates
- Video guides

**Rewards:**
- $50-200 for comprehensive guides
- Recognition in docs
- Contributor badge

### Testing & QA
- Bug reports with reproduction steps
- Security vulnerability reports (see [Security Policy](../../SECURITY.md))
- Testnet verification
- Performance testing

**Rewards:**
- $50-500 for critical bug finds
- Up to $1000 for security vulnerabilities
- Recognition in security hall of fame

---

## 🌍 Community Channels

### Primary Channels

| Platform | Purpose | Link |
|----------|---------|------|
| 💬 Telegram | Real-time chat, questions | [Join](https://t.me/nofx_dev_community) |
| 🐙 GitHub | Issues, PRs, discussions | [Visit](https://github.com/NoFxAiOS/nofx) |
| 🐦 Twitter | Announcements, updates | [@nofx_official](https://x.com/nofx_official) |

### Core Team

- **Tinkle** - [@Web3Tinkle](https://x.com/Web3Tinkle)
- **Tintin** - [@Tintinx2021](https://x.com/Tintinx2021)

**Contact:**
- Technical questions → Telegram or GitHub Issues
- Business inquiries → Twitter DM to core team
- Security reports → [SECURITY.md](../../SECURITY.md)

---

## 📅 Community Events

### Regular Activities
- **Weekly Updates** - Development progress (Telegram)
- **Monthly AMA** - Ask maintainers anything
- **Quarterly Roadmap** - Future plans discussion

### Upcoming Events
- *No scheduled events yet*

**Want to organize an event?**
- Contact core team on Telegram
- Propose in GitHub Discussions
- Tweet and tag @nofx_official

---

## 🎓 Learning Resources

### For Contributors

**Understanding NOFX:**
- [System Architecture](../architecture/README.md) *(coming soon)*
- [API Reference](../architecture/api-reference.md) *(coming soon)*
- [Database Schema](../architecture/database-schema.md) *(coming soon)*

**Learning Materials:**
- Go programming: [Tour of Go](https://go.dev/tour/)
- React/TypeScript: [React Docs](https://react.dev/)
- Trading basics: [Binance Academy](https://academy.binance.com/)

### Recommended Reading

1. **Before Contributing:**
   - [Contributing Guide](../../CONTRIBUTING.md)
   - [Code of Conduct](../../CODE_OF_CONDUCT.md)

2. **For Exchange Integration:**
   - [Hyperliquid Bounty](bounty-hyperliquid.md)
   - [Aster Bounty](bounty-aster.md)
   - Existing code: `trader/binance_futures.go`

3. **For AI Features:**
   - [Custom API Guide](../getting-started/custom-api.md)
   - MCP client code: `mcp/client.go`
   - Decision engine: `decision/engine.go`

---

## 🛡️ Community Guidelines

### Our Values
- **Respect** - Treat everyone with courtesy
- **Transparency** - Open communication and decisions
- **Quality** - High standards for contributions
- **Collaboration** - Work together, help each other

### Not Acceptable
- ❌ Harassment or discrimination
- ❌ Spam or self-promotion
- ❌ Sharing malicious code
- ❌ Violating [Code of Conduct](../../CODE_OF_CONDUCT.md)

**Violations will result in:**
1. Warning
2. Temporary ban
3. Permanent ban (serious cases)

---

## 📊 Community Stats

| Metric | Count |
|--------|-------|
| GitHub Stars | Check [repo](https://github.com/NoFxAiOS/nofx) |
| Contributors | 21+ |
| Open Issues | Check [issues](https://github.com/NoFxAiOS/nofx/issues) |
| Merged PRs | Check [pulls](https://github.com/NoFxAiOS/nofx/pulls?q=is%3Apr+is%3Amerged) |

---

## 🚀 Quick Links

- **Want to contribute code?** → [Contributing Guide](../../CONTRIBUTING.md)
- **Want to claim bounty?** → [Bounty Guide](bounty-guide.md)
- **Found a security issue?** → [Security Policy](../../SECURITY.md)
- **Have questions?** → [Telegram Community](https://t.me/nofx_dev_community)

---

[← Back to Documentation Home](../README.md)
