-
Notifications
You must be signed in to change notification settings - Fork 6
/
Copy pathindex.html
137 lines (130 loc) · 4.48 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
<!DOCTYPE html>
<!--
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
Version 2, December 2004
Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
Everyone is permitted to copy and distribute verbatim or modified
copies of this license document, and changing it is allowed as long
as the name is changed.
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. You just DO WHAT THE FUCK YOU WANT TO.
-->
<html>
<head>
<meta property="fb:admins" content="1022979132" />
<title>Your Bug Report Needs More Info</title>
<style type="text/css">
body {
font-family: Arial, sans-serif;
}
h1 {
margin-top: 1.5em;
}
h2 {
margin: 1.25em auto 0.5em auto;
}
#wrapper {
width: 960px;
margin: auto;
}
p, ul {
line-height: 1.5em;
}
li {
margin-bottom: .5em;
}
footer {
position: absolute;
bottom: 0;
right: 0;
padding: 5px;
}
</style>
<script>
(function(d, s, id) {
var js, fjs = d.getElementsByTagName(s)[0];
if (d.getElementById(id)) {return;}
js = d.createElement(s); js.id = id;
js.src = "//connect.facebook.net/en_US/all.js#xfbml=1";
fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'facebook-jssdk'));
</script>
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-3592613-2']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
</head>
<body>
<div id="wrapper">
<div id="fb-root"></div>
<h1>Hello there!</h1>
<p>
You've been directed to this website because you submitted a bug report to
an open source project, but you provided too little information for the
developers to be able to help you. Does this look familiar?
</p>
<blockquote>
<em>
Hi, I'm getting a weird error when I use <program>, do you know
what might be wrong?
</em>
</blockquote>
<p>
Debugging software is hard, even when you have the code in front of you.
Now imagine, trying to debug software on somebody else's computer, without
any access to the code, without knowing what operating system is on the
computer, or even what version of your software is being used. Your only
hint is that "there's a weird error" and you have 1 line out of a 50 line
stack trace to work with. Sound impossible? That's because it is!
</p>
<h2>So you want help?</h2>
<p>
If you want to actually get your problem solved, here is how you can
submit a good bug report that a developer will actually respond to:
</p>
<ul>
<li>
Got a stack trace? Send the whole thing - or better yet, send a link to
it pasted on <a href="http://gist.github.com">Gist</a> or <a
href="http://pastie.org">Pastie</a>.
</li>
<li>
Provide context, for example what version of Ruby or Python or COBOL or
whatever you're using, as well as the code that causes the problem.
Again, Gist and Pastie are your friends.
</li>
<li>
Better yet, create a small program that reproduces the problem, and put
it on <a href="http://github.com">Github</a>, or zip it and send it in
an email.
</li>
<li>
Even better yet, if you are able to, add a failing test case that
demonstrates the problem you are having, and send it as a pull request
or patch.
</li>
</ul>
<h2>Too much info?</h2>
<p>
If you only remember one thing, remember this: <b>reproducibility is
key.</b> If I can't reproduce your problem, I can't fix it.
</p>
<h2>Not enough info?</h2>
<p>
For a longer guide on proper bug reporting, please check
<a href="/tatham/en.html">Simon Tatham's excellent article</a>.
</p>
<footer>
By <a href="http://twitter.com/compay">@compay</a>
<a href="https://github.com/norman/yourbugreportneedsmore.info">Fork me</a>
</footer>
</div>
</body>
</html>