Skip to main content

Documentation

Contributing

Contributing to Stackhouse

Contributing

๐Ÿค Contributing to Stackhouse

Thank you for your interest in contributing!

Getting Started

# Fork the repository
# Click "Fork" on GitHub

# Clone your fork
git clone https://github.com/YOUR_USERNAME/stackhouse-stack.git
cd stackhouse-stack/stackhouse

# Add upstream remote
git remote add upstream https://github.com/ArjavDesa912/stackhouse.git

# Create feature branch
git checkout -b feature/your-feature-name

Development Setup

# Install Rust toolchain
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Build Stackhouse
cargo build --release

# Run tests
cargo test

# Run with logging
RUST_LOG=debug cargo run

Code Style

# Format code
cargo fmt

# Run linter
cargo clippy -- -D warnings

# Run checks
cargo check --all-features

Making Changes

  1. Create a branch for each feature
  2. Write tests for new functionality
  3. Update documentation if needed
  4. Commit with clear messages

Pull Request Process

# Push to your fork
git push origin feature/your-feature-name

# Create Pull Request on GitHub
# Include:
# - Description of changes
# - Related issues
# - Testing done

Contribution Areas

We welcome contributions in:

  • ๐Ÿ› Bug fixes
  • โœจ New features
  • ๐Ÿ“š Documentation
  • ๐Ÿงช Tests
  • โšก Performance improvements
  • ๐ŸŒ Internationalization

Code Review Process

  • All PRs require review
  • At least one approval needed
  • CI must pass
  • Tests must pass

Getting Help


Ready to contribute? Start coding! ๐Ÿš€