Basic Guide
This guide is intended to help people with little or no development knowledge. If you have already contributed with open source projects in GitHub, you can skip to intermediate guide.
This guide covers:
- Required software;
- GitHub basics;
- How to communicate with the team;
The steps below cover all these 3 topics.
Steps
This is an open source project hosted in GitHub. All source code, test and documentation can be found in the project GitHub page. It's necessary that you download and install .NET Core 2.1.
Follow the steps below to install and configure the project in your computer.
- Sign Up for a GitHub Account;
- Download and install Git;
- (Optional) Download and install Git Desktop, GitKraken or SourceTree;
- Configure Git to use your GitHub account;
- Fork the project and clone it in your computer.
- Download and install .NET Core 2.1. Remember to install the correct version depending on your OS.
- Download a IDE compatible with C#;
- Clone the forked project in your machine;
- Add another remote using the official project URL;
- Create a new branch in your repository. If you are just exploring the project and does not intent to send any changes, you can skip this step.
- (For documentation only) To change the project documentation, you need to download and install Node;
- (For documentation only) Using the command line, access the
website
folder inside neo-sharp and runnpm i
. This step may take a few minutes since it will install several project dependencies; - (For documentation only) Using the command line, access the
website
folder inside neo-sharp and runnpm start
; - Create an issue in GitHub to propose the changes you want to make;
- Propose your changes with a PullRequest.
MacOS
For MacOS users, it's necessary to install RocksDB.