Skip to content

Contributing ​

Thank you for your interest in contributing to Flash! We welcome contributions from the community. To ensure a smooth process for everyone, please follow these guidelines when contributing.

How to Contribute ​

1. Fork the Repository ​

Start by forking the repository to your own GitHub account. This allows you to make changes without affecting the main project.

  • Navigate to the Flash repository.
  • Click on the Fork button at the top right of the page to create a copy in your own GitHub account.

2. Create a New Branch ​

Once you've forked the repository, create a new branch for the changes you want to make. It's important to keep your changes isolated in a separate branch.

You can create a branch from the command line like this:

git checkout -b my-feature-branch

Make sure to give your branch a descriptive name related to the feature or bugfix you're working on.

3. Make Your Changes ​

Edit, refactor, or improve the code as needed. Be sure to follow the project's coding style and best practices.

  • If you're adding a new feature, consider writing tests to cover your changes.
  • If you're fixing a bug, ensure that your fix solves the issue without introducing new problems.

4. Commit Your Changes ​

Once you've made your changes, commit them with a clear, concise commit message that describes what you've done. Use conventional commit messages to keep the history clean and understandable.

For example:

git commit -m "Add feature to listen for specific columns"

5. Push Your Branch ​

After committing your changes, push your branch to your forked repository on GitHub:

git push origin my-feature-branch

6. Open a Pull Request ​

Once your changes are pushed to your forked repository, open a pull request (PR) to merge your changes into the main repository.

  • Go to the original repository (not your fork) on GitHub.
  • Click on the New Pull Request button.
  • Select your feature branch and the main branch of the repository as the base.
  • Provide a detailed description of what your PR does and any context or explanations for your changes.

7. Review and Feedback ​

Once your PR is submitted, the maintainers will review it. They may request changes or provide feedback. Be open to feedback and make the necessary adjustments.

8. Merging ​

After your PR has been reviewed and approved, a maintainer will merge it into the main repository.

Code of Conduct ​

Please be respectful and kind to others when contributing. We want to maintain a positive and welcoming environment for all contributors.

  • Be respectful: Treat everyone with respect and consideration.
  • Be collaborative: Work with others to create the best solutions.
  • Be inclusive: Embrace diversity and welcome contributions from everyone.

Thank you for contributing to Flash! Your help makes the project better for everyone.