-
-
Notifications
You must be signed in to change notification settings - Fork 3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #2889 from ipfs/feature/github-issues-guide
Added a How To File GitHub Issues guide
- Loading branch information
Showing
1 changed file
with
79 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,79 @@ | ||
# How to file a GitHub Issue | ||
|
||
We use GitHub Issues to log all of our todos and tasks. Here is [a good guide](https://guides.github.com/features/issues/) for them if you are unfamiliar. | ||
|
||
When logging an issue with go-ipfs, it would be useful if you specified the below information, if possible. This will help us triage the issues faster. Please title your issues with the type. For instance: | ||
|
||
- "bug: Cannot add file with `ipfs add`" | ||
- "question: How do I use `ipfs block <hash>`?" | ||
|
||
Putting the command in backticks helps us parse the natural language description, and is generally suggested. | ||
|
||
This is a _living guide_. If you see anything that should be here and isn't, or have ideas on improvement, please open a "meta" issue. | ||
|
||
### Type | ||
|
||
- "bug": If what you are filing is a bug. | ||
- "meta": If it is something about how we run go-ipfs, and not code related in itself. | ||
- "question": If you have a question. | ||
- "test failure": If the tests are failing | ||
- "panic": If it is a severe bug. | ||
- "enhancement ": If you have a feature you would like that enhances go-ipfs. | ||
|
||
### Platform | ||
|
||
For platform and processor, just run `ipfs version --all` and include that output. | ||
|
||
Your platform. | ||
|
||
- "Linux" | ||
- "Windows" | ||
- "Mac" | ||
- Etc. | ||
|
||
### Processor | ||
|
||
Your processor. | ||
|
||
- "x86" | ||
- "amd64" | ||
- "Arm" | ||
|
||
### Area | ||
|
||
What your issue refers to. Multiple items are OK. | ||
|
||
- "api" | ||
- "bandwidth reduction" | ||
- "bit swap" | ||
- "blockstore" | ||
- "commands" | ||
- "containers + vms" | ||
- "core" | ||
- "daemon + init" | ||
- "dat" | ||
- "discovery" | ||
- "encryption" | ||
- "files" | ||
- "fuse" | ||
- "gateway" | ||
- "gx" | ||
- "interior" | ||
- "pins" | ||
- "libp2p" | ||
- "merkledag" | ||
- "nat" | ||
- "releases" | ||
- "repo" | ||
- "routing" | ||
- "tools" | ||
- "tracking" | ||
- "unix vs dag" | ||
|
||
### Priority | ||
|
||
- "P0 - Operations Functioning" | ||
- "P1 - Operations Sort of Functioning" | ||
- "P2 - Operations Not Functioning" | ||
- "P3 - Operations Foobar (critical bug affecting master)" | ||
- "P4 - Operations on Fire (critical bug affecting release)" |