Skip to content

Latest commit

 

History

History
143 lines (107 loc) · 3.85 KB

CONTRIBUTING.md

File metadata and controls

143 lines (107 loc) · 3.85 KB
Raw

Contributing to Reactive 🚀

First off, thank you for considering contributing to Reactive! We're excited to have you join our community.

Quick Links

Choose Your Path

🌱 Are you new to open source?

If this is your first time contributing to an open source project, head over to our New to Open Source section. We've created a beginner-friendly guide just for you!

🚀 Already familiar with open source?

If you're an experienced contributor, check out our Experienced Contributor Guide to get started right away.

New to Open Source

Welcome to your first open source contribution! We're here to help you get started.

1. First Steps 👣

Don't worry if this seems like a lot - we'll help you through it! Here's what you'll need:

2. Getting Ready 🎯

  1. Fork the Repository

    • Go to our GitHub repository
    • Click the "Fork" button in the top right
    • This creates your own copy of our project!

  2. Clone Your Fork

    git clone https://github.com/YOUR-USERNAME/reactive.git

    (Replace YOUR-USERNAME with your GitHub username)

3. Make Your First Contribution 🎉

  1. Find an Issue

    • Look for issues labeled good first issue in our repository
    • Comment on the issue saying you'd like to work on it
    • We'll guide you through it!

  2. Make Changes

    • Create a new branch for your work
    git checkout -b my-first-contribution
    • Make your changes
    • Test them out

  3. Submit Your Work

    • Push your changes
    • Create a Pull Request
    • We'll review it and provide feedback!

4. Need Help? 🤝

Experienced Contributor Guide

Development Environment

Prerequisites

  • Node.js (v14+)
  • VS Code
  • Git

Setup

  1. Fork and clone the repository
  2. Install dependencies: 
    npm install
  3. Create a new branch: 
    git checkout -b feature/your-feature-name

Contribution Guidelines

Code Style

  • Use TypeScript
  • Follow existing code formatting
  • Add comments for complex logic
  • Include tests for new features

Pull Request Process

  1. Update documentation as needed
  2. Add tests for new features
  3. Ensure all tests pass
  4. Update the README if needed
  5. Reference any related issues

Commit Conventions

  • Use the present tense ("Add feature" not "Added feature")
  • Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
  • Reference issues in commit messages

Testing

  • Write Jest/React Testing Library tests
  • Ensure existing tests pass
  • Test across different VS Code versions

Project Structure

reactive/
├── src/           # Source code
├── test/          # Test files
├── docs/          # Documentation
└── examples/      # Example files

Review Process

  1. Submit Pull Request
  2. Address review feedback
  3. Ensure CI checks pass
  4. Await maintainer review

Getting Help

  • Check existing issues and documentation
  • Open a new issue with the question label
  • Join our community discussions

Thank you for contributing to Reactive! 🎉