Contributing to async-wait-until
April 4, 2025 ยท View on GitHub
First off, thank you for considering contributing to async-wait-until! It's people like you that make this project better for everyone.
Table of Contents
- Code of Conduct
- Getting Started
- Pull Requests
- Development Workflow
- Coding Style
- Testing
- Reporting Bugs
- Suggesting Features
- License
Code of Conduct
This project and everyone participating in it is governed by our Code of Conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to the project maintainers.
Getting Started
Prerequisites
- Node.js (version specified in package.json)
- npm or yarn
Setup
- Fork the repository
- Clone your fork:
git clone https://github.com/YOUR-USERNAME/async-wait-until.git - Navigate to the project directory:
cd async-wait-until - Install dependencies:
npm installoryarn install - Create a new branch for your changes:
git checkout -b feature/your-feature-name
Pull Requests
- Ensure your code passes all tests
- Update documentation if necessary
- Include relevant tests for your changes
- Ensure your commits are well-formatted and descriptive
- Submit a pull request to the
mainbranch
Pull Request Process
- Update the README.md with details of changes if applicable
- Increase the version numbers in package.json and other relevant files following Semantic Versioning
- The PR will be merged once it has been reviewed and approved by a maintainer
Development Workflow
- Make your changes
- Run tests:
npm testoryarn test - Lint your code:
npm run lintoryarn lint - Fix any issues before committing
Coding Style
- This project uses ESLint and Prettier for code formatting
- Follow the existing code style
- Use descriptive variable and function names
- Add comments for complex logic
Testing
- Write tests for new features and bug fixes
- Ensure all tests pass before submitting a PR
- Aim for good test coverage
Reporting Bugs
When reporting bugs, please include:
- A clear and descriptive title
- Steps to reproduce the issue
- Expected behavior
- Actual behavior
- Environment information (OS, Node.js version, etc.)
- Any relevant logs or screenshots
Suggesting Features
When suggesting features:
- Clearly describe the feature and its benefits
- Provide examples of how it would be used
- Indicate if you're willing to help implement it
License
By contributing, you agree that your contributions will be licensed under the same license as the project.
Thank you for contributing to async-wait-until!