Skip to content

Latest commit

 

History

History
135 lines (86 loc) · 4.64 KB

CONTRIBUTING.md

File metadata and controls

135 lines (86 loc) · 4.64 KB

Contributing Guide

Thanks for taking the time to contribute!

Table of contents

Code of Conduct

Contribution prerequisites

Project Setup

How can you contribute

Additional Notes

Code of Conduct

This project and everyone contributing to it adheres to the ResearchGate Code of Conduct. By participating you are expected to uphold this code. Please report any behavior you find unacceptable to [email protected].

Contribution prerequisites

Before you start your work, make sure that you:

Project setup

How to run the project

Create a clone of the repository:

git clone https://github.com/researchgate/react-intersection-list.git
cd react-intersection-list

Install the dependencies with:

npm install

Now run storybook:

npm run storybook

How to run tests

This project uses jest for JavaScript testing.

To run tests, execute:

yarn test

Since coverage is not collected by default when running yarn test, run:

yarn coverage

To run linters use:

yarn lint

How you can contribute

Reporting bugs

This section guides you through the steps to follow when you submit a bug report for a ResearchGate project.

Following these guidelines makes it easy for the maintainers and community to understand your report, reproduce the behavior, and find related reports.

Before creating a bug report, please check Open Issues as you may find that there is already an issue open for the bug you’ve found. When you create a bug report, be sure to include as much detail as possible and fill out the required template, the information it asks for helps us resolve issues faster.

After you have submitted the issue, we'll try to get back to you as soon as possible.

Suggesting enhancements

This section guides you through submitting a feature suggestion.

All enhancement suggestions are tracked as GitHub issues and, when approved by a core team member or project maintainer, are given the green light to then be turned into a Pull Request. For the best possible experience, please provide us with:

  • A clear and descriptive title
  • A step-by-step description of the suggested enhancement and what it should do
  • Specific examples to demonstrate the steps. Ideally, you should support it with code snippets, screenshots, and/or animated GIFs
  • Explanation of why this feature would be useful to this project
  • Your development environment and context for creating the feature

After you have submitted your Pull Request, we'll try to get back to you as soon as possible.

Writing documentation

All great projects require good documentation. There is always room for (better) docs, so why not to contribute to the project by enhancing them? Please do so via Pull Request.

Your first code contribution

Unsure where you can start contributing? We strive to make all our projects easy for beginners to contribute to. Just look out for issues labeled help-wanted and beginner-friendly, then get stuck in! If you still need some guidance, consider this resource and/or contact us.

Additional notes

Issue and pull request templates

When filing an issue or pull request, please take the time to fill out the templates we provide in as much detail as you can. This helps ensure that we have all the information we need to provide you with the right support so that your experience contributing to our open-source project runs as smoothly and easily as you would like it to.

Need help?

If you need any help or require additional information, don't hesitate to contact the project maintainer or any of the contributors.

Thank you for contributing!