We warmly welcome contributions from the community and are grateful for your interest in helping improve the EigenTrust NEAR smart contract. By participating, you agree to abide by our code of conduct and contribute constructively.
Contributions can take various forms, from bug reports and feature requests to code submissions. Here’s how you can contribute:
Before reporting a bug, please check our issue tracker to avoid duplicates. When reporting a bug, include:
- A clear and concise description of what the bug is.
- Steps to reproduce the behavior.
- Expected behavior.
- Screenshots if applicable.
- Additional context or code snippets that might help identify the issue.
Feature requests are welcome. Please open an issue and provide:
- A clear and concise description of the feature.
- Explain the problem it solves or why the feature would be beneficial.
- Any additional context such as mockups, references, or screenshots.
We love direct contributions to the codebase. Here’s how you can submit a pull request (PR):
-
Fork the Repository: Start by forking the repository and cloning your fork to your local machine.
-
Create a Branch: Create a branch in your fork for your contributions.
git checkout -b feature/AmazingFeature
-
Make Your Changes: Add your changes to this branch. Please adhere to the existing coding style and document your code appropriately.
-
Write Tests: If you are adding functionality, write unit tests that cover your changes.
-
Run Tests: Ensure all tests pass, including your new ones.
cargo test
-
Commit Your Changes: Use meaningful commit messages that explain your changes.
git commit -m 'Add some AmazingFeature'
-
Push to the Branch: Push your changes to your GitHub repository.
git push origin feature/AmazingFeature
-
Open a Pull Request: Go to the original repository and open a pull request from your feature branch. Fill in the PR template with all relevant information.
Once a pull request is submitted, the repository maintainers will review it. This process might require some discussions and further modifications. Please be patient and address feedback to expedite this process.
- Use the imperative mood in the commit message subject line.
- Start the commit message with an applicable verb such as "Add", "Update", "Fix", "Remove", etc.
- First line should be under 50 characters, followed by a blank line and a more detailed description if needed.
- Follow the Rust Style Guide.
- Use
cargo fmt
to format your code. - Ensure your code is well-documented with comments explaining "why" something is done, not just "what".
- If you need assistance or want to discuss a topic related to the project, use Discussions in the project repository (link to project discussions if available).
Participation in this project is governed by Code of Conduct. By participating, you are expected to uphold this code.