<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/en/2172/18/9/_/styles/combined.css?spaceKey=AST&forWysiwyg=true" type="text/css">
</head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
<h2><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Issue+Guidelines">Asterisk Issue Guidelines</a></h2>
<h4>Page <b>added</b> by <a href="https://wiki.asterisk.org/wiki/display/~rnewton">Rusty Newton</a>
</h4>
<br/>
<div class="notificationGreySide">
<p>(index table with links to all headings)</p>
<div>
<ul>
<li><a href='#AsteriskIssueGuidelines-STATEMENTOFPURPOSE'>STATEMENT OF PURPOSE</a></li>
<ul>
<li><a href='#AsteriskIssueGuidelines-Whyshouldyoureadthis%3F'>Why should you read this?</a></li>
</ul>
<li><a href='#AsteriskIssueGuidelines-HOWTOREPORTABUG'>HOW TO REPORT A BUG</a></li>
<ul>
<li><a href='#AsteriskIssueGuidelines-OVERVIEWOFWHATMAKESAUSEFULBUGREPORT%3F'>OVERVIEW OF WHAT MAKES A USEFUL BUG REPORT?</a></li>
<li><a href='#AsteriskIssueGuidelines-STOP%5C%21BEFOREYOUEVENTHINKABOUTFILINGABUGREPORT...'>STOP! BEFORE YOU EVEN THINK ABOUT FILING A BUG REPORT...</a></li>
<li><a href='#AsteriskIssueGuidelines-INFOTOINCLUDEWHENSUBMITTING'>INFO TO INCLUDE WHEN SUBMITTING</a></li>
<li><a href='#AsteriskIssueGuidelines-HOWYOUCANSPEEDUPBUGRESOLUTION'>HOW YOU CAN SPEED UP BUG RESOLUTION</a></li>
<li><a href='#AsteriskIssueGuidelines-REASONSYOURREPORTMAYBECLOSEDOUT'>REASONS YOUR REPORT MAY BE CLOSED OUT</a></li>
<li><a href='#AsteriskIssueGuidelines-DOYOUHAVEAPATCH%3F'>DO YOU HAVE A PATCH?</a></li>
</ul>
<li><a href='#AsteriskIssueGuidelines-CONTRIBUTORLICENSEAGREEMENT'>CONTRIBUTOR LICENSE AGREEMENT</a></li>
</ul></div>
<h2><a name="AsteriskIssueGuidelines-STATEMENTOFPURPOSE"></a>STATEMENT OF PURPOSE</h2>
<p>The <a href="https://issues.asterisk.org/jira" class="external-link" rel="nofollow">Asterisk Issue Tracker</a> is used to track bugs and miscellaneous (documentation) elements within the Asterisk project. The issue tracker is designed to manage reports on both <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Module+Support+States" class="external-link" rel="nofollow">core and extended components</a> of the Asterisk project. The Asterisk project's issue tracker is currently located at <a href="https://issues.asterisk.org/jira" class="external-link" rel="nofollow">issues.asterisk.org</a>.</p>
<p>The primary use of the issue tracker is to track bugs, where "bug" means anything that causes unexpected or detrimental results in the Asterisk system. The secondary purpose it is to track some of the miscellaneous issues surrounding Asterisk, such as documentation, commentary, improvements with associated patches.</p>
<p>Features requests are not accepted through the issue tracker. Features requests are openly discussed on the mailing lists and Asterisk IRC channels and made note of by Bug Marshalls.</p>
<h4><a name="AsteriskIssueGuidelines-Whyshouldyoureadthis%3F"></a>Why should you read this?</h4>
<p>If you want your bug fixed, or if you want anyone to pay serious attention to your request, you'll need to read and understand this article.</p>
<h2><a name="AsteriskIssueGuidelines-HOWTOREPORTABUG"></a>HOW TO REPORT A BUG</h2>
<h4><a name="AsteriskIssueGuidelines-OVERVIEWOFWHATMAKESAUSEFULBUGREPORT%3F"></a>OVERVIEW OF WHAT MAKES A USEFUL BUG REPORT?</h4>
<p>There are some key qualities to keep in mind. These should be reflected in your bug report to increase the chance of getting your bug fixed.</p>
<ul>
<li>Specific</li>
<li>Reproducible</li>
<li>Sufficient data</li>
</ul>
<h4><a name="AsteriskIssueGuidelines-STOP%5C%21BEFOREYOUEVENTHINKABOUTFILINGABUGREPORT..."></a>STOP! BEFORE YOU EVEN THINK ABOUT FILING A BUG REPORT...</h4>
<p>are you using the latest version of your branch? (we understand this may not be easy to test)</p>
<p>are you using the latest third party software, firmware, model, etc?</p>
<p>have you asked for help in the community (mailling list, IRC, forums) ?</p>
<h4><a name="AsteriskIssueGuidelines-INFOTOINCLUDEWHENSUBMITTING"></a>INFO TO INCLUDE WHEN SUBMITTING</h4>
<p>about your system</p>
<p>about your asterisk version</p>
<p>about third party software involved in the scenario</p>
<h4><a name="AsteriskIssueGuidelines-HOWYOUCANSPEEDUPBUGRESOLUTION"></a>HOW YOU CAN SPEED UP BUG RESOLUTION</h4>
<p>you will have done a lot by following the checklist and including all information that we have asked for. Watch for emails where we may ask for additional data that we didn't forsee needing ahead of time, or else may require your assistance in testing a patch or troubleshooting.</p>
<h4><a name="AsteriskIssueGuidelines-REASONSYOURREPORTMAYBECLOSEDOUT"></a>REASONS YOUR REPORT MAY BE CLOSED OUT</h4>
<p>blah</p>
<h2><a name="AsteriskIssueGuidelines-HOWTOREQUESTAFEATURE%5C%5C"></a>HOW TO REQUEST A FEATURE<br class="atl-forced-newline" /></h2>
<h4><a name="AsteriskIssueGuidelines-DOYOUHAVEAPATCH%3F"></a>DO YOU HAVE A PATCH?</h4>
<p>blah</p>
<h2><a name="AsteriskIssueGuidelines-CONTRIBUTORLICENSEAGREEMENT"></a>CONTRIBUTOR LICENSE AGREEMENT</h2>
<p>blah</p>
<p>blah</p>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;" class="grey">
<a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST">Stop watching space</a>
<span style="padding: 0px 5px;">|</span>
<a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action">Change email notification preferences</a>
</div>
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Issue+Guidelines">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Issue+Guidelines?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>