-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
8 changed files
with
60 additions
and
127 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,86 +1,61 @@ | ||
# Welcome to Scaffold-ETH 2 Contributing Guide | ||
# Contributing Guidelines | ||
|
||
Thank you for investing your time in contributing to Scaffold-ETH 2! | ||
Thank you for considering contributing to the Lightning EVM Bridge project! Before you start, please take a moment to review the following guidelines to help streamline the contribution process and ensure a positive collaborative experience. | ||
|
||
This guide aims to provide an overview of the contribution workflow to help us make the contribution process effective for everyone involved. | ||
## How Can I Contribute? | ||
|
||
## About the Project | ||
Contributions to the Lightning EVM Bridge project can come in various forms, including but not limited to: | ||
|
||
Scaffold-ETH 2 is a minimal and forkable repo providing builders with a starter kit to build decentralized applications on Ethereum. | ||
- Reporting bugs | ||
- Suggesting enhancements | ||
- Fixing issues by opening pull requests | ||
- Writing tests | ||
- Improving documentation | ||
- Providing feedback on discussions | ||
|
||
Read the [README](README.md) to get an overview of the project. | ||
## Getting Started | ||
|
||
### Vision | ||
To contribute to the project, follow these steps: | ||
|
||
The goal of Scaffold-ETH 2 is to provide the primary building blocks for a decentralized application. | ||
1. Fork the repository and create your branch from `main`. | ||
2. Clone your forked repository to your local machine. | ||
3. Make your changes and ensure that they adhere to the coding standards and guidelines. | ||
4. Test your changes thoroughly. | ||
5. Commit your changes with clear and concise commit messages. | ||
6. Push your changes to your forked repository. | ||
7. Open a pull request to the `main` branch of the original repository. | ||
|
||
The repo can be forked to include integrations and more features, but we want to keep the master branch simple and minimal. | ||
## Code Quality and Standards | ||
|
||
### Project Status | ||
- Follow the existing code style and conventions. | ||
- Write clear and concise code and comments. | ||
- Ensure that your changes do not introduce linting errors or warnings. | ||
- Write comprehensive tests for new features or changes. | ||
|
||
The project is under active development. | ||
## Issue Reporting | ||
|
||
You can view the open Issues, follow the development process and contribute to the project. | ||
If you encounter any bugs, issues, or have suggestions for enhancements, please search the existing issues before opening a new one to avoid duplicates. When opening an issue, provide detailed information, including steps to reproduce the problem or context for the enhancement. | ||
|
||
## Getting started | ||
## Pull Request Guidelines | ||
|
||
You can contribute to this repo in many ways: | ||
When submitting a pull request, please: | ||
|
||
- Solve open issues | ||
- Report bugs or feature requests | ||
- Improve the documentation | ||
- Provide a clear and descriptive title for your pull request. | ||
- Reference any related issues in the pull request description using GitHub issue linking syntax (`#issue_number`). | ||
- Include a brief summary of your changes and their purpose. | ||
- Ensure that all tests pass successfully. | ||
- Rebase your branch on top of the latest `main` branch before opening a pull request to simplify the merge process. | ||
|
||
Contributions are made via Issues and Pull Requests (PRs). A few general guidelines for contributions: | ||
## Review Process | ||
|
||
- Search for existing Issues and PRs before creating your own. | ||
- Contributions should only fix/add the functionality in the issue OR address style issues, not both. | ||
- If you're running into an error, please give context. Explain what you're trying to do and how to reproduce the error. | ||
- Please use the same formatting in the code repository. You can configure your IDE to do it by using the prettier / linting config files included in each package. | ||
- If applicable, please edit the README.md file to reflect the changes. | ||
Pull requests will undergo a review process by project maintainers. Reviews may include feedback, suggestions, or requests for changes. Contributors are expected to address any review comments promptly and professionally. | ||
|
||
### Issues | ||
## Maintainers | ||
|
||
Issues should be used to report problems, request a new feature, or discuss potential changes before a PR is created. | ||
The following individuals are maintainers of the Lightning EVM Bridge project: | ||
|
||
#### Solve an issue | ||
- [Diyahir](mailto:me@diyahir.com) | ||
|
||
Scan through our [existing issues](https://github.com/scaffold-eth/scaffold-eth-2/issues) to find one that interests you. | ||
Feel free to reach out to them directly for any project-related inquiries or assistance. | ||
|
||
If a contributor is working on the issue, they will be assigned to the individual. If you find an issue to work on, you are welcome to assign it to yourself and open a PR with a fix for it. | ||
|
||
#### Create a new issue | ||
|
||
If a related issue doesn't exist, you can open a new issue. | ||
|
||
Some tips to follow when you are creating an issue: | ||
|
||
- Provide as much context as possible. Over-communicate to give the most details to the reader. | ||
- Include the steps to reproduce the issue or the reason for adding the feature. | ||
- Screenshots, videos etc., are highly appreciated. | ||
|
||
### Pull Requests | ||
|
||
#### Pull Request Process | ||
|
||
We follow the ["fork-and-pull" Git workflow](https://github.com/susam/gitpr) | ||
|
||
1. Fork the repo | ||
2. Clone the project | ||
3. Create a new branch with a descriptive name | ||
4. Commit your changes to the new branch | ||
5. Push changes to your fork | ||
6. Open a PR in our repository and tag one of the maintainers to review your PR | ||
|
||
Here are some tips for a high-quality pull request: | ||
|
||
- Create a title for the PR that accurately defines the work done. | ||
- Structure the description neatly to make it easy to consume by the readers. For example, you can include bullet points and screenshots instead of having one large paragraph. | ||
- Add the link to the issue if applicable. | ||
- Have a good commit message that summarises the work done. | ||
|
||
Once you submit your PR: | ||
|
||
- We may ask questions, request additional information or ask for changes to be made before a PR can be merged. Please note that these are to make the PR clear for everyone involved and aims to create a frictionless interaction process. | ||
- As you update your PR and apply changes, mark each conversation resolved. | ||
|
||
Once the PR is approved, we'll "squash-and-merge" to keep the git commit history clean. | ||
Thank you for contributing to the Lightning EVM Bridge project! 🎉 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters