-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
44 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,44 @@ | ||
# Contributing to Absytree | ||
|
||
In this guide you will get an overview of the contribution workflow from opening an issue, creating a PR, reviewing, and merging the PR. | ||
|
||
## New contributor guide | ||
|
||
To get an overview of the project, read the [README](README.md) and [Getting Started](docs/getting_started.md). | ||
|
||
### Issues | ||
|
||
#### Create a new issue | ||
|
||
If you find a bug or want to request a feautre, search if an issue already exists. If a related issue doesn't exist, you can open a new issue. | ||
|
||
For bugs please give as much information as possible. | ||
Please include the log file (`messages.log` in the root folder where you installed/cloned Absytree) if it's a bug and the commands and their outputs in case of compile errors. | ||
|
||
#### Solve an issue | ||
|
||
Scan through our [existing issues](https://github.com/github/docs/issues) to find one that interests you. You can narrow down the search using `labels` as filters. | ||
|
||
### Make Changes | ||
|
||
1. Fork the repository. | ||
2. Install Nim 2.0.2 | ||
3. Create a working branch and start with your changes! | ||
4. Make sure you're changes work in the desktop/terminal/browser version | ||
|
||
#### Developing/Testing the browser version | ||
|
||
TODO | ||
|
||
### Pull Request | ||
|
||
For bugfixes, tests or small obvious features/improvements (e.g. implementing more Vim Keybindings) you can directly create a pull request. | ||
For everything else please create an issue first so we can discuss if it even makes sense to include that feature and how it should work. | ||
|
||
When you're finished with the changes, create a pull request, also known as a PR. | ||
- Don't forget to [link PR to issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue) if you are solving one. | ||
- Enable the checkbox to [allow maintainer edits](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork) so the branch can be updated for a merge. | ||
|
||
Once you submit your PR, I will review your proposal. Please note that I have a full time job, and I'm only working on this in my free time, so I might take a while to get to your PR. | ||
- As you update your PR and apply changes, mark each conversation as [resolved](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request#resolving-conversations). | ||
- If you run into any merge issues, checkout this [git tutorial](https://github.com/skills/resolve-merge-conflicts) to help you resolve merge conflicts and other issues. |