Keyboard shortcuts

Press โ† or โ†’ to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

How to Contribute

Thank you for your interest in contributing to Helios Engine! This document provides guidelines and information for contributors.

๐Ÿš€ Quick Start for Contributors

Development Setup

  1. Clone the repository:

    git clone https://github.com/Ammar-Alnagar/Helios-Engine.git
    cd Helios-Engine
    
  2. Build the project:

    cargo build
    
  3. Run tests:

    cargo test
    
  4. Format code:

    cargo fmt
    
  5. Check for issues:

    cargo clippy
    

First Contribution

  1. Fork the repository on GitHub
  2. Create a feature branch: git checkout -b feature/your-feature-name
  3. Make your changes
  4. Run tests: cargo test
  5. Format code: cargo fmt
  6. Check for issues: cargo clippy
  7. Commit your changes: git commit -m "Add your feature"
  8. Push to your fork: git push origin feature/your-feature-name
  9. Create a Pull Request

๐Ÿ—๏ธ Development Workflow

Branching Strategy

  • main: Production-ready code
  • develop: Integration branch for features
  • feature/*: New features
  • bugfix/*: Bug fixes
  • hotfix/*: Critical fixes for production

Commit Messages

Follow conventional commit format:

type(scope): description

[optional body]

[optional footer]

๐Ÿงช Testing

Running Tests

# Run all tests
cargo test

# Run specific test
cargo test test_name

๐Ÿ“š Documentation

Documentation Standards

  • Use Markdown for all documentation
  • Include code examples where relevant
  • Provide both conceptual and practical information
  • Keep documentation up-to-date with code changes
  • Use clear, concise language accessible to different experience levels