Contributing to Rooch
Thank you for your interest in contributing to Rooch! There are many ways to contribute and we appreciate all of them.
- Communicating in our Discord channel (opens in a new tab), share your new ideas, talk technologies
- Learning Rooch
- Reporting bugs
- Requesting new features
- Submitting PRs
To contribute to the Rooch source code or documentation, you need a GitHub account.
There are usually two ways to submit a PR:
One is to edit directly in the repository on the GitHub website, and after submitting the changes, push them directly to the main branch. This method is especially suitable for submitting simple PRs such as correcting typos. It is not recommended to use this method when multiple files are involved or there are many changes.
Another way is to
forkthe Rooch repository under your own account, and
cloneit locally, and then push it to the upstream
mainbranch (referring to the Rooch organization) after the modification is completed. The branch on your own GitHub is called a remote branch.
First, create a fork of the
rooch repository in your own account so that you can use your own copy.
- Log in to your Github account.
- Browse the Rooch repo (opens in a new tab) on GitHub.
Forkin the upper right corner, then select
Create a new fork.
- For Owner, select your username.
- For the Repository name, we recommend keeping the name
rooch, but you can use any name.
- Optional. To contribute, you only need the main branch of the repository. To include all branches, uncheck the checkbox for Copy the
Next, clone the fork of the repository to your local repository.
- Open the repository page of your fork, and click the
Sync forkbutton (no operation is usually required for the fork just now, and synchronization is only required if your forked repository commits lags behind the upstream repository).
- Click on
Code, then click on
HTTPSand copy the displayed web URL.
- Open a terminal session and navigate to the folder you want to use, then run the following command, replacing the URL with the one you copied from the GitHub page:
git clone https://github.com/<GITHUB-USER-NAME>/rooch.git`
After cloning is completed, you can modify any file in the
rooch directory. By default, the clone is the default branch (can be set in GitHub), usually the
Before making corresponding changes to Rooch's project, you need to perform the most important step: creating a new topic branch.
In general, it is not recommended to submit a PR to Rooch's upstream directly using the
main branch, which is not conducive to the collaboration of Rooch maintainers with you.
When you have completed the modification, submitted and pushed the changes to the remote repository, you can usually see a
Compare & pull request pop-up button on the GitHub page, just click and fill in the corresponding information.
The content is usually filled in automatically. If you feel that the title or the content description of this PR is not accurate enough, you can continue to modify it.
After the modification is complete, click the
Create pull request button below, and your PR will appear on Rooch's
Pull requests page.
Reporting issues and submitting feature requests is usually done by submitting corresponding issue posts on the
When you want to report a bug, please open Rooch's GitHub Issues page (opens in a new tab). In the search bar above, simply search for your question, maybe the question you found may have been submitted by others, so avoid duplicating submissions.If there is no bug post you want to report, please click the
New issue button on the upper right, enter a brief description of the current bug as the title, and fill in the detailed description of the current bug in the content box, including your operating (system) environment, the version of Rooch used, and the process of reproducing the problem, etc.
When you want to request a new feature, fill in the brief description of the feature on the title bar of the current Issues page as the title, and add
[Feature Request] as the identifier before the title.
After filling in the relevant information, click on
Lables on the right, label it accordingly, and click on the
Submit new issue button below.