Skip to content

Commit 2df1631

Browse files
committed
Create Contributing.md
1 parent 3fd84a5 commit 2df1631

File tree

1 file changed

+49
-0
lines changed

1 file changed

+49
-0
lines changed

Contributing.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# Reporting a Bug
2+
3+
The way you report a bug is the most critical part for a quick resolution. Bugs which lack clear description and steps to reproduce are often not fixed. If you find a bug please make sure that you log the bug based on the template below. Make sure that you are as descriptive as possible.
4+
5+
## Bug Template
6+
7+
### Title: Line of text which summarizes what the bug is about. (Max 70 characters)
8+
9+
- Be short and precise
10+
- Use simple language and grammar
11+
- Summarize what the issue is and nothing else
12+
13+
### Description: Describe the issue in a few lines using simple words
14+
15+
While describing a bug consider that you are describing it to someone who knows nothing about your problem. Be as elaborate as possible but avoid being verbose. Being verbose here would mean.
16+
- Providing unnecessary details without which the bug can still be described.
17+
18+
In most of the cases, try to understand the bug in such a way that you can separate program can be written just to reproduce the issue. If you are not able to understand the bug at this moment, just try to recreate the problem with simplest possible code.
19+
20+
### Things to include in the Description
21+
- What went wrong? for e.g. Adding a long description to a test results in truncation of the text.
22+
- When it went wrong? for e.g. If you add a text description which is greater than 255 characters, the description text gets truncated
23+
24+
Things to NOT include in the Description
25+
- You application specific details. For example, do not give elaborate background on what your application does.
26+
- Talking about functions/code which is very specific to your project. We would not know about that.
27+
28+
### Steps to Reproduce:
29+
- Detailed and precise steps to reproduce the bugs.
30+
- Make sure that preconditions are specified. For e.g. include a particular library or tool which is necessary to reproduce the scenario.
31+
- If possible you can attach images with annotations explaining where the problem is.
32+
- If possible create a piece of code which can reproduce the issue without having any of your application/framework code.
33+
34+
### Expected Results
35+
In the end make sure that you clearly explain what were you expecting. Being very clear here is the key.
36+
37+
38+
# What happens after you have logged the bug?
39+
40+
We look at bugs periodically. As this is an open source project, we invest time based on the availability. You can expect a reply within 2 - 3 days. If you donot get a reply, please add any of the contributors in the list.
41+
42+
You can also raise a PR if you know the fix. PR's are always welcome. Please see the code contribution guidelines below.
43+
44+
45+
46+
47+
48+
49+

0 commit comments

Comments
 (0)