56 lines
3.0 KiB
Markdown
56 lines
3.0 KiB
Markdown
# Contributing
|
|
|
|
The core developer team of Fleek Non Fungible Apps welcomes all contributions from the community to achieve consistent code updates and enhancements.
|
|
|
|
If you want to help us improve the project, you can always start a conversation through the [issues page](https://github.com/fleekxyz/non-fungible-apps/issues). Make sure you are being respectful towards the members of the community. We take our open-source community seriously and hold ourselves and other contributors to high communication standards.
|
|
|
|
|
|
## Getting Started
|
|
|
|
Contributions are made to this repository via Issues and Pull Requests (PRs). A few general guidelines that cover both:
|
|
|
|
|
|
1. Search for existing related Issues and PRs before creating your own.
|
|
2. Make sure you are clear about your ideas and expose as much information as you can (e.g. code samples, images).
|
|
3. We will be working hard to respond to all Issues as soon as possible, but it can take time to investigate root causes. Please be patient.
|
|
|
|
|
|
If you don't know where to start, you can take a look in the [Getting Started section on our wiki](https://github.com/fleekxyz/non-fungible-apps/wiki/%F0%9F%93%98-Getting-Started).
|
|
|
|
## Issues
|
|
|
|
The issues page is open to discuss about any subject that is tangible to the project, it can be any problem report, feature request, potential changes, etc.
|
|
|
|
If you find any topics related to your subject, please feel free to post your story and provide any kind of information you think it might help.
|
|
|
|
## Pull Requests
|
|
|
|
All PRs are welcome and it will be the fastest way to solve your issue. We are going to kindly review all of them as fast as possible.
|
|
|
|
You are able to create branches from the `main` branch and name it in accordance to **conventional
|
|
commits** [here](https://www.conventionalcommits.org/en/v1.0.0/), or follow the examples bellow:
|
|
|
|
```txt
|
|
test: adding missing tests
|
|
feat: a new feature
|
|
fix: a bug fix
|
|
chore: build process or auxiliary tool changes
|
|
docs: documentation only changes
|
|
refactor: code change that neither fixes a bug or adds a feature
|
|
style: markup, white-space, formatting, missing semi-colons...
|
|
```
|
|
|
|
Please ensure your code is clear and readable and also provide as much information you can in the description.
|
|
|
|
> ⚠️ Your code and any changes made needs to be covered with tests
|
|
|
|
> ⚠️ In case of need, you have to provide all documentation changes within your PR
|
|
|
|
## Testing
|
|
|
|
We are up to write tests using both [Hardhat](https://hardhat.org/) and [Foundry](https://book.getfoundry.sh/) frameworks. Its mandatory that all tests were well described and all validations to make the code consistent and secure. To get more information about it, check the [Testing section on our wiki](https://github.com/fleekxyz/non-fungible-apps/wiki/%F0%9F%93%98-Getting-Started#testing). You can also get some examples of how to test it on [test folder](/test).
|
|
|
|
## Getting help
|
|
|
|
Join us on our [Discord Server](https://discord.gg/fleekxyz). Let's build a great community together!
|