Community

Welcome to the AstraWeave community! This page lists resources for connecting with other developers, getting help, and contributing to the project.

Official Channels

GitHub

The primary home for AstraWeave development:

Resource	Description
Repository	Source code, issues, and pull requests
Discussions	Q&A, ideas, and general discussion
Issues	Bug reports and feature requests
Projects	Development roadmap and tracking

Discord

Join our Discord server for real-time chat:

#general - Introduce yourself and chat with the community
#help - Get help with AstraWeave questions
#showcase - Share your projects and creations
#ai-discussion - Discuss AI/LLM integration topics
#development - Engine development discussion
#announcements - Official news and updates

Twitter/X: @AstraWeaveEngine - News and updates
YouTube: AstraWeave - Tutorials and devlogs
Reddit: r/astraweave - Community discussions

Getting Help

Before Asking

Search existing resources:
Prepare your question:
- Describe what you’re trying to do
- Show what you’ve tried
- Include relevant code snippets
- Share error messages

Where to Ask

Question Type	Best Channel
Quick questions	Discord #help
Detailed technical questions	GitHub Discussions
Bug reports	GitHub Issues
Feature requests	GitHub Issues or Discussions
Security issues	security@astraweave.dev (private)

How to Ask Good Questions

## What I'm trying to do
I want to create an AI companion that follows the player and helps in combat.

## What I've tried
```rust
// My current code
fn companion_follow(
    companion: Query<&mut Transform, With<Companion>>,
    player: Query<&Transform, With<Player>>,
) {
    // This doesn't work as expected
}

What happens

The companion doesn’t move at all.

What I expected

The companion should move toward the player.

Environment

AstraWeave 0.1.0
Windows 11


## Contributing

### Ways to Contribute

Everyone can contribute, regardless of experience level:

| Contribution | Description |
|--------------|-------------|
| **Bug Reports** | Found a bug? Report it on GitHub Issues |
| **Documentation** | Improve or add documentation |
| **Code** | Fix bugs or implement features |
| **Examples** | Create example projects |
| **Testing** | Test pre-release versions |
| **Translations** | Help translate documentation |
| **Community** | Help others in Discord/Discussions |

### Getting Started

1. **Read the contributing guide**: [Contributing](../dev/contributing.md)
2. **Set up your development environment**: [Building](../dev/building.md)
3. **Find a good first issue**:
   - Look for `good first issue` labels on GitHub
   - Check the `help wanted` label for more challenging tasks

### Code Contribution Workflow

```bash
# 1. Fork and clone
git clone https://github.com/YOUR_USERNAME/astraweave.git
cd astraweave

# 2. Create a branch
git checkout -b feature/my-feature

# 3. Make changes
# ... edit files ...

# 4. Run tests
cargo test --all

# 5. Commit
git commit -am "feat: add my feature"

# 6. Push and create PR
git push origin feature/my-feature

Pull Request Guidelines

Keep PRs focused: One feature or fix per PR
Write tests: Cover new functionality with tests
Update docs: Add documentation for new features
Follow style: Match existing code style
Be patient: Reviews take time

Showcase

Share your AstraWeave projects!

How to Submit

Discord: Post in #showcase with:
- Project name
- Brief description
- Screenshots or video
- Link (if public)
GitHub Discussions: Create a post in the “Show and Tell” category