-
Notifications
You must be signed in to change notification settings - Fork 5
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
1 parent
e83bbcc
commit 9ed171e
Showing
1 changed file
with
22 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,22 @@ | ||
## How to contribute | ||
|
||
Please note that this project is released with a [Contributor Code of Conduct](./CODE_OF_CONDUCT.md). By participating you agree to abide by its terms. | ||
|
||
We appreciate you taking the time to contribute to Octokit or any of the projects in Octokit's ecosystem. Especially as a new contributor, you have a valuable perspective: you will find things confusing and run into problems that no longer occur to the maintainers. Please share them with us so we can make the experience for future contributors the best it can be. | ||
|
||
Thank you 💖 | ||
|
||
There are two types of contributions: issues and pull requests (PRs). Issues are used to track bugs and feature requests, while PRs contribute new content to the repository. | ||
|
||
## Creating an issue | ||
|
||
Before you create a new issue: | ||
1. Search the [project's issues](https://github.com/octokit/dotnet-sdk/issues) to see if a similar issue already exists. If so, please add onto that issue rather than creating a new one. | ||
1. If submitting a bug report, include steps and a minimal code sample that will reproduce the issue. | ||
1. If submitting a feature request, please share the motivation for the new feature, what alternatives you considered, and any implementation suggestions. | ||
|
||
## Creating a pull request | ||
|
||
First, fork the repository. If you're not sure how to do so, please read [the linked docs](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo). Then clone your fork and `cd` to that directory locally. | ||
|
||
Ensure that the `scripts/install-tools.sh`, `scripts/generate-go.sh`, and `scripts/generate-dotnet.sh` commands each succeed. Note that you'll need to clone `octokit/go-sdk` and `octokit/dotnet-sdk` in a sibling directory to this repository. Make your code changes (adding tests and documentation as necessary) and confirm the above validation steps still pass (as well as builds and tests in the generated repositories). If you'd like to debug the project, you can use VSCode's tooling to do so. When you're satisfied with your changes, follow [GitHub's docs](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) to create your PR. |