Skip to content

Commit

Permalink
Added a How To File GitHub Issues guide
Browse files Browse the repository at this point in the history
See #2786

License: MIT
Signed-off-by: Richard Littauer <richard.littauer@gmail.com>
  • Loading branch information
RichardLitt committed Jun 22, 2016
1 parent 79e9bd8 commit d785b4e
Showing 1 changed file with 77 additions and 0 deletions.
77 changes: 77 additions & 0 deletions docs/github-issue-guide.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
# 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

Your platform.

- "Linux"
- "Windows"
- "Mac"
- Etc.

### Processor

Your processor.

- "32"
- "64"
- "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)"

0 comments on commit d785b4e

Please sign in to comment.