# Community

Welcome to the Gonzo community! This page helps you connect with other users, contribute to the project, and get support.

### Getting Involved

#### For Users

**Share Your Experience**:

* ⭐ Star the project on [GitHub](https://github.com/control-theory/gonzo)
* 📝 Write blog posts about using Gonzo
* 🐦 Share tips and tricks on social media
* 💬 Help answer questions in discussions
* 📸 Share screenshots of your setups

**Provide Feedback**:

* 🐛 Report bugs you encounter
* 💡 Suggest new features
* 📊 Share use cases we haven't considered
* 🎨 Propose UI improvements

#### For Developers

**Contribute Code**:

* 🔧 Fix bugs
* ✨ Implement new features
* 🧪 Add tests
* 📚 Improve documentation
* 🎨 Create custom skins
* 📋 Create custom format parsers

**Help Others**:

* 🤝 Review pull requests
* 👥 Mentor new contributors
* 💬 Answer technical questions
* 📖 Improve documentation clarity

### Blog & Content

**ControlTheory Blog**: Regular posts about Gonzo, log analysis, and SRE practices

* [View all blog posts →](https://www.controltheory.com/blog/)
* [Subscribe to newsletter →](https://www.controltheory.com/newsletter)

### Communication Channels

#### GitHub

**Primary Platform**: <https://github.com/control-theory/gonzo>

**Issues**: Report bugs and request features

* Bug reports: Use the bug template
* Feature requests: Use the enhancement template
* Questions: Use the question label
* Good first issues: Look for "good first issue" label

**Discussions**: General conversations

* Q\&A: Ask and answer questions
* Ideas: Brainstorm new features
* Show and tell: Share what you've built
* General: Anything Gonzo-related

**Pull Requests**: Contribute code

* Fork, branch, commit, push
* Follow contribution guidelines
* Wait for review and feedback
* Iterate based on comments

#### ControlTheory Website

**Blog**: <https://www.controltheory.com/blog/>

* Product announcements
* Technical deep dives
* Use case studies
* Best practices

**Documentation**: <https://docs.controltheory.com/gonzo>

* Comprehensive guides
* API documentation
* Examples and tutorials
* Troubleshooting tips

#### Social Media

**Twitter/X**: Follow [@ControlTheoryHQ](https://twitter.com/ControlTheoryHQ)

* Product updates
* Quick tips
* Community highlights

**LinkedIn**: [ControlTheory Company Page](https://www.linkedin.com/company/controltheory)

* Professional updates
* Case studies
* Job postings

### Recognition

#### Contributors

We recognize and celebrate all contributors:

**Hall of Fame**:

* Listed in GitHub contributors
* Mentioned in release notes
* Featured in project README
* Community spotlight posts

**Special Recognition**:

* 🥇 **Top Contributors**: Most impactful contributions
* 🏆 **Bug Hunters**: Found and reported critical bugs
* 📚 **Documentation Heroes**: Significantly improved docs
* 🎨 **Design Contributors**: Created popular skins/themes
* 🔧 **Tool Builders**: Created useful extensions

#### Star History

See our growth: [Star History Chart](https://star-history.com/#control-theory/gonzo\&Date)

Help us reach more users by starring the project!

### Resources

#### Learning Resources

**Getting Started**:

* Quick Start Guide
* Installation
* Basic Usage

**Advanced Topics**:

* AI Integration
* OTLP Protocol
* Custom Formats

**For Contributors**:

* Development Setup
* Contribution Guidelines
* Architecture Overview

#### Example Configurations

**Community Configs**:

* Check `examples/` directory in repository
* Browse community-shared configurations
* Submit your own configs via PR

**Custom Formats**:

* Apache/Nginx parsers
* Application-specific formats
* Cloud service integrations

**Custom Skins**:

* Color scheme variations
* Brand-specific themes
* Accessibility-focused themes

### Community Projects

#### Integrations

**Log Shippers**:

* Fluent Bit configurations
* Logstash pipelines
* Vector configs

**Monitoring Systems**:

* Prometheus integration
* Grafana dashboards
* Alertmanager rules

**CI/CD**:

* GitHub Actions workflows
* GitLab CI pipelines
* Jenkins integrations

#### Tools & Extensions

**Community Tools**:

* Log generators for testing
* Format converters
* Analysis scripts
* Automation tools

**Complementary Projects**:

* Log aggregation tools
* Parsing libraries
* Visualization tools

Submit your projects to be featured here!

### Events & Activities

#### Hackathons

Participate in Gonzo-focused hackathons:

* Build new features
* Create integrations
* Design themes
* Write documentation

**Past Hackathons**:

* Check GitHub discussions for recaps
* See winning projects
* Get inspired for future events

#### Community Calls

**Monthly Community Calls** (when scheduled):

* Product roadmap discussions
* Feature demonstrations
* Q\&A with maintainers
* Community presentations

Watch for announcements in GitHub Discussions.

#### Meetups

**Virtual Meetups**:

* User presentations
* Live demos
* Technical discussions
* Networking

**Local Meetups**:

* Connect with local users
* In-person demos
* Collaborative sessions

Interested in organizing? Reach out to maintainers!

### Support

#### Getting Help

**Documentation First**:

* Check [documentation](https://docs.controltheory.com/gonzo)
* Search [existing issues](https://github.com/control-theory/gonzo/issues)
* Browse [discussions](https://github.com/control-theory/gonzo/discussions)

**Ask the Community**:

* Post in GitHub Discussions (Q\&A)
* Open an issue with "question" label
* Share details about your setup

**Commercial Support**:

* Email: <support@controltheory.com>
* Enterprise support plans available
* Custom feature development

#### Reporting Security Issues

**⚠️ Do not open public issues for security vulnerabilities**

Instead:

* Email: <security@controltheory.com>
* Provide detailed description
* Include steps to reproduce
* Suggest potential fixes if possible

We aim to respond within 48 hours.

### Code of Conduct

#### Our Pledge

We pledge to make participation in our community a harassment-free experience for everyone, regardless of:

* Age, body size, disability
* Ethnicity, gender identity and expression
* Experience level
* Nationality, personal appearance
* Race, religion
* Sexual identity and orientation

#### Our Standards

**Positive Behavior**:

* ✅ Using welcoming and inclusive language
* ✅ Being respectful of differing viewpoints
* ✅ Gracefully accepting constructive criticism
* ✅ Focusing on what is best for the community
* ✅ Showing empathy towards others

**Unacceptable Behavior**:

* ❌ Trolling, insulting, or derogatory comments
* ❌ Personal or political attacks
* ❌ Public or private harassment
* ❌ Publishing others' private information
* ❌ Other conduct inappropriate in professional settings

#### Enforcement

Violations may result in:

* Warning
* Temporary ban
* Permanent ban

Report issues to: <conduct@controltheory.com>

### Roadmap

#### Current Focus

**Short-term** (Next 3 months):

* Performance improvements
* Bug fixes and stability
* Documentation enhancements
* Community feedback implementation

**Medium-term** (3-6 months):

* New AI providers
* Enhanced OTLP features
* Additional integrations
* Plugin system

**Long-term** (6+ months):

* Distributed log analysis
* Advanced visualizations
* Cloud-native deployments
* Enterprise features

See [GitHub Projects](https://github.com/control-theory/gonzo/projects) for detailed roadmap.

#### Influence the Roadmap

**Your input matters**:

* 👍 Upvote issues you care about
* 💬 Comment on proposals
* 📝 Submit feature requests
* 🗳️ Participate in polls

Popular requests get prioritized!

### Credits

#### Built With

Gonzo is built with these amazing open-source projects:

* [**Bubble Tea**](https://github.com/charmbracelet/bubbletea) - TUI framework
* [**Lipgloss**](https://github.com/charmbracelet/lipgloss) - Styling library
* [**Bubbles**](https://github.com/charmbracelet/bubbles) - TUI components
* [**Cobra**](https://github.com/spf13/cobra) - CLI framework
* [**Viper**](https://github.com/spf13/viper) - Configuration
* [**OpenTelemetry**](https://opentelemetry.io/) - Observability standard
* [**drain3**](https://github.com/logpai/Drain3) - Pattern extraction

#### Inspiration

Inspired by:

* [**k9s**](https://k9scli.io/) - Kubernetes TUI
* [**stern**](https://github.com/stern/stern) - Multi-pod log tailing
* [**lnav**](https://lnav.org/) - Log file navigator

#### Team

**Maintainers**:

* Core maintainers listed in [GitHub](https://github.com/control-theory/gonzo)
* ControlTheory team

**Contributors**:

* See [Contributors](https://github.com/control-theory/gonzo/graphs/contributors)
* Everyone who reported bugs
* Everyone who suggested features
* Everyone who improved docs

#### Sponsors

Support Gonzo's development:

* GitHub Sponsors (coming soon)
* Open Collective (coming soon)
* Corporate sponsorship inquiries: <partnerships@controltheory.com>

### Stay Connected

#### Newsletter

Subscribe to our newsletter:

* Product updates
* Tips and tricks
* Community highlights
* Event announcements

Sign up at: <https://www.controltheory.com/newsletter>

#### Blog

Read the latest:

* [**Gonzo Blog**](https://www.controltheory.com/blog/tag/gonzo)
* Technical articles
* Use cases
* Best practices

#### Social Media

Follow us:

* **Twitter/X**: [@ControlTheoryHQ](https://twitter.com/ControlTheoryHQ)
* **LinkedIn**: [ControlTheory](https://www.linkedin.com/company/controltheory)
* **GitHub**: [control-theory](https://github.com/control-theory)

#### Contact

**General Inquiries**: <hello@controltheory.com> **Support**: <support@controltheory.com> **Security**: <security@controltheory.com> **Press**: <press@controltheory.com> **Partnerships**: <partnerships@controltheory.com>

***

### Thank You! 🎉

Thank you for being part of the Gonzo community. Whether you're using it, contributing to it, or just checking it out - we appreciate you!

**Together, we're making log analysis better for everyone.**

{% hint style="success" %}
**Want to get involved?** Start by starring the [GitHub repo](https://github.com/control-theory/gonzo), join the [discussions](https://github.com/control-theory/gonzo/discussions), and say hello!
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.controltheory.com/controltheory-documentation/gonzo-docs/contributing/community.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.