1
0
mirror of https://github.com/oceanprotocol/docs.git synced 2024-11-26 19:49:26 +01:00
docs/contribute/README.md

80 lines
5.3 KiB
Markdown
Raw Normal View History

2018-11-09 18:31:55 +01:00
---
title: Ways to Contribute
description: Help develop Ocean Protocol software like a superhero
cover: ../.gitbook/assets/cover/contribute.png
coverY: 0
2018-11-09 18:31:55 +01:00
---
# 🤝 Contribute
<figure><img src="../.gitbook/assets/to-the-computer.gif" alt=""><figcaption></figcaption></figure>
2021-01-14 12:59:33 +01:00
### Report a bug 🐞
2021-01-15 08:37:17 +01:00
Do you think you see a bug in our code? To report a bug that _isn't a vulnerability_, go to the relevant GitHub repository, click on the _Issues_ tab, and select _Bug report_.
First, make sure that you search existing open + closed issues + PRs to see if your bug has already been reported there. If not, then go ahead and create a new bug report! 🦸
2021-01-14 12:59:33 +01:00
### Report vulnerabilities
For all the super sleuths out there, you may be able to earn a bounty for reporting vulnerabilities in sensitive parts of our code. Check out our page on [Immunify](https://immunefi.com/bounty/oceanprotocol/) for the latest bug bounties available. You can also responsibly disclose flaws by emailing us at [security@oceanprotocol.com](mailto:security@oceanprotocol.com).
2021-01-14 12:59:33 +01:00
<figure><img src="../.gitbook/assets/matrix-code.gif" alt=""><figcaption><p>Did you find a glitch in our code matrix?</p></figcaption></figure>
### Suggest a new feature 🤔💭
2021-01-14 12:59:33 +01:00
2021-01-14 13:13:03 +01:00
Use the _Issues_ section of each repository and select _Feature request_ to suggest and discuss any features you would like to see added.
2021-01-14 12:59:33 +01:00
As with bug reports, don't forget to search existing open + closed issues + PRs to see if something has already been suggested.
2021-01-15 08:37:17 +01:00
### Improve core software
It takes a tribe of awesome coders to build our tech stack, and you're invited to pitch in 😊 We'd love to have you contribute to any repository within the `oceanprotocol` GitHub organization!
2021-01-14 12:04:15 +01:00
Before you start coding, please follow these basic guidelines:
* If no issue for your case is present, please open one first before starting to work on something, so it can be discussed openly with Ocean core team.
* Make yourself familiar with the repository-specific contribution requirements and code style requirements.
* Because of the weird world of intellectual property, we need you to follow the [legal requirements](legal-reqs.md) for contributing code.
* Be excellent to each other in the comments, as outlined in our [Contributor Code of Conduct](code-of-conduct.md).
#### Your contribution workflow
2021-01-14 12:04:15 +01:00
1. As an external developer, fork the respective repo and **push your code changes to your own fork.** Ocean core developers push directly on the repo under `oceanprotocol` org.
2. Then, create a new branch for your changes from our public repo's main branch. The naming convention for new branches is: `issue-001-short-feature-description`. The issue number `issue-001` needs to reference the GitHub issue that you are trying to fix. The short feature description helps us to quickly distinguish your branch among the other branches in play.
2021-01-15 08:37:17 +01:00
3. To get visibility and Continuous Integration feedback as early as possible, open your Pull Request as a `Draft`.
4. Give it a meaningful title, and at least link to the respective issue in the Pull Request description, like `Fixes #23`. Describe your changes, mention things for reviewers to look out for, and for UI changes screenshots and videos are helpful.
2021-01-14 11:27:57 +01:00
5. Once your Pull Request is ready, mark it as `Ready for Review`, in most repositories code owners are automatically notified and asked for review.
6. Get all CI checks green and address eventual change requests.
2021-01-15 08:37:17 +01:00
7. If your PR stays open for longer and merge conflicts are detected, merge or rebase your branch against the current `main` branch.
8. Once a Pull Request is approved, you can merge it.
Depending on the release management of each repository, your contribution will be either included in a next release, or deployed live automatically.
2021-01-14 11:27:57 +01:00
Except for GitHub, you can chat with most Ocean Protocol core developers in our [Discord](https://discord.gg/TnXjkR5) if you have further development questions.
### Develop an dApp or integration on top of Ocean Protocol
2021-01-15 08:37:17 +01:00
We LOVE builders of dApps on Ocean! Nothing makes us feel prouder than seeing you create awesome things with our open-source tools.&#x20;
2018-11-09 18:31:55 +01:00
If you need ANY help, then we're here to talk with you on [Discord](https://discord.gg/TnXjkR5) to give you advice. We're also consistently improving our docs to help you. And... you're here :)
2018-11-11 04:02:34 +01:00
### Improve our docs
2021-01-15 08:37:17 +01:00
Our docs repo can always be improved. If you found a mistake or have an improvement to make, then follow the steps in our [contribution workflow](./#your-contribution-workflow) to commit your changes.
2021-01-14 12:59:33 +01:00
### Apply for a developer job
2020-12-15 15:30:05 +01:00
Do you REALLY love building on Ocean Protocol? Consider joining us full time! Our openings are listed at [https://github.com/oceanprotocol/jobs](https://github.com/oceanprotocol/jobs).
2020-12-15 15:30:05 +01:00
### Get funding
2022-07-26 15:12:41 +02:00
You might be able to get funding from us for contributing to our core software, building dApps on top of our tech, creating integrations, fixing bugs, doing community outreach, and more. Checkout our active funding programs for more information:
2022-07-26 15:12:41 +02:00
* [**Shipyard**](https://oceanprotocol.com/shipyard) (Ocean curated grants).
* [**Data Challenges**](https://oceanprotocol.com/bounties) (rewards for publishing algorithms and datasets).
2022-07-26 15:12:41 +02:00
### Talk to us!
Check our our [Community Page](https://www.oceanprotocol.com/community) for our social media links where you can join the buzz around Ocean or chat with us directly 😊 Toodles!