<html>
<head>
<meta name="viewport" content="width=device-width" />
<base href="https://wiki.asterisk.org/wiki" />
<style type="text/css">
body, #email-content, #email-content-inner { font-family: Arial,FreeSans,Helvetica,sans-serif; }
body, p, blockquote, pre, code, td, th, li, dt, dd { font-size: 13px; }
small { font-size: 11px; }
body { width:100% !important; -webkit-font-smoothing: antialiased; }
body,
#email-wrapper { background-color: #f0f0f0; }
#email-wrapper-inner { padding: 20px; text-align: center; }
#email-content-inner { background-color: #fff; border: 1px solid #bbb; color: $menuTxtColour; padding:20px; text-align:left; }
#email-wrapper-inner > table { width: 100%; }
#email-wrapper-inner.thin > table { margin: 0 auto; width: 50%; }
#email-footer { padding: 0 16px 32px 16px; margin: 0; }
.email-indent { margin: 8px 0 16px 0; }
.email-comment { margin: 0 0 0 56px; }
.email-comment.removed { background-color: #ffe7e7; border: 1px solid #df9898; padding: 0 8px;}
#email-title-avatar { text-align: left; vertical-align: top; width: 48px; padding-right: 8px; }
#email-title-flavor { margin: 0; padding: 0 0 4px 0; }
#email-title-heading { font-size: 16px; line-height: 20px; min-height: 20px; margin: 0; padding: 0; }
#email-title .icon { border: 0; padding: 0 5px 0 0; text-align: left; vertical-align: middle; }
#email-actions { border-top: 1px solid #bbb; color: #505050; margin: 8px 0 0 0; padding: 0; }
#email-actions td { padding-top: 8px; }
#email-actions .left { max-width: 45%; text-align: left; }
#email-actions .right { text-align: right; }
.email-reply-divider { border-top: 1px solid #bbb; color: #505050; margin: 32px 0 8px 0; padding: 8px 0; }
.email-section-title { border-bottom: 1px solid #bbb; margin: 8px 0; padding: 8px 0 0 0; }
.email-metadata { color: #505050; }
a { color: #326ca6; text-decoration: none; }
a:hover { color: #336ca6; text-decoration: underline; }
a:active {color: #326ca6; }
a.email-footer-link { color: #505050; font-size: 11px; }
.email-item-list { list-style: none; margin: 4px 0; padding-left: 0; }
.email-item-list li { list-style: none; margin: 0; padding: 4px 0; }
.email-list-divider { color: #505050; padding: 0 0.35em; }
.email-operation-icon { padding-right: 5px; }
.avatar { -ms-interpolation-mode: bicubic; border-radius: 3px;}
.avatar-link { margin: 2px; }
.tableview th { border-bottom: 1px solid #69C; font-weight: bold; text-align: left; }
.tableview td { border-bottom: 1px solid #bbbbbb; text-align: left; padding: 4px 16px 4px 0; }
.aui-message { margin: 1em 0; padding: 8px; }
.aui-message.info { background-color: #e0f0ff; border: 1px solid #9eb6d4; }
.aui-message.success { background-color: #ddfade; border: 1px solid #93c49f; }
.aui-message.error,
.aui-message.removed { background-color: #ffe7e7; border: 1px solid #df9898; color: #000; }
.call-to-action-table { margin: 10px 1px 1px 1px;}
.call-to-cancel-container, .call-to-action-container { padding: 5px 20px; }
.call-to-cancel-container { border: 1px solid #aaa; background-color: #eee; border-radius: 3px; }
.call-to-cancel-container a.call-to-cancel-button { background-color: #eee; font-size: 14px; line-height: 1; padding: 0; margin: 0; color: #666; font-family: sans-serif;}
.call-to-action-container { border: 1px solid #486582; background-color: #3068A2; border-radius: 3px; padding: 4px 10px; }
.call-to-action-container a.call-to-action-button { background-color: #3068A2; font-size: 14px; line-height: 1; padding: 0; margin: 0; color: #fff; font-weight: bold; font-family: sans-serif; }
/** The span around the inline task checkbox image */
.diff-inline-task-overlay {
display: inline-block;
text-align: center;
height: 1.5em;
padding: 5px 0px 1px 5px;
margin-right: 5px;
/** Unfortunately, the negative margin-left is stripped out in gmail */
margin-left: -5px;
}
@media handheld, only screen and (max-device-width: 480px) {
div, a, p, td, th, li, dt, dd { -webkit-text-size-adjust: auto; }
small, small a { -webkit-text-size-adjust: 90%; }
td[id=email-wrapper-inner] { padding: 2px !important; }
td[id=email-content-inner] { padding: 8px !important; }
td[id="email-wrapper-inner"][class="thin"] > table { text-align: left !important; width: 100% !important; }
td[id=email-footer] { padding: 8px 12px !important; }
div[class=email-indent] { margin: 8px 0px !important; }
div[class=email-comment] { margin: 0 !important; }
p[id=email-title-flavor] a { display: block; } /* puts the username and the action on separate lines */
p[id=email-permalink] { padding: 4px 0 0 0 !important; }
table[id=email-actions] td { padding-top: 0 !important; }
table[id=email-actions] td.right { text-align: right !important; }
table[id=email-actions] .email-list-item { display: block; margin: 1em 0 !important; word-wrap: normal !important; }
span[class=email-list-divider] { display: none; }
}
</style>
</head>
<body style="font-family: Arial, FreeSans, Helvetica, sans-serif; font-size: 13px; width: 100%; -webkit-font-smoothing: antialiased; background-color: #f0f0f0">
<table id="email-wrapper" width="100%" cellspacing="0" cellpadding="0" border="0" style="background-color: #f0f0f0">
<tbody>
<tr valign="middle">
<td id="email-wrapper-inner" style="font-size: 13px; padding: 20px; text-align: center">
<table id="email-content" cellspacing="0" cellpadding="0" border="0" style="font-family: Arial, FreeSans, Helvetica, sans-serif; width: 100%">
<tbody>
<tr valign="top">
<td id="email-content-inner" align="left" style="font-family: Arial, FreeSans, Helvetica, sans-serif; font-size: 13px; background-color: #fff; border: 1px solid #bbb; padding: 20px; text-align: left">
<table id="email-title" cellpadding="0" cellspacing="0" border="0" width="100%">
<tbody>
<tr>
<td id="email-title-avatar" rowspan="2" style="font-size: 13px; text-align: left; vertical-align: top; width: 48px; padding-right: 8px"> <img class="avatar" src="cid:avatar_ce51dcf276530e4a4b00548e2a6d0905" border="0" height="48" width="48" style="-ms-interpolation-mode: bicubic; border-radius: 3px" /> </td>
<td valign="top" style="font-size: 13px">
<div id="email-title-flavor" class="email-metadata" style="margin: 0; padding: 0 0 4px 0; color: #505050">
<a href=" https://wiki.asterisk.org/wiki/display/~mjordan " style="color:#326ca6;text-decoration:none;; color: #326ca6; text-decoration: none">Matt Jordan</a> edited the page:
</div> </td>
</tr>
<tr>
<td valign="top" style="font-size: 13px"> <h2 id="email-title-heading" style="font-size: 16px; line-height: 20px; min-height: 20px; margin: 0; padding: 0"> <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Issue+Guidelines" style="color: #326ca6; text-decoration: none"> <img class="icon" src="cid:page-icon" alt="" style="border: 0; padding: 0 5px 0 0; text-align: left; vertical-align: middle" /> <strong style="font-size:16px;line-height:20px;vertical-align:top;">Asterisk Issue Guidelines</strong> </a> </h2> </td>
</tr>
</tbody>
</table>
<div class="email-indent" style="margin: 8px 0 16px 0">
<div class="email-diff">
<div id="page-diffs" class="wiki-content">
<p class="diff-block-target" style="font-size: 13px"> <span class="diff-html-added" id="added-diff-0" style="font-size: 100%; background-color: #ddfade;"> </span> </p>
<p class="diff-block-context" style="font-size: 13px"> </p>
<table class="diff-macro bodyless" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;margin: 5px 0; padding: 0; width: auto;">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;; font-size: 13px"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB-1988229788/4252/6ac85e9b14675c5514a674e1aecae99c9505ed36.48/_/images/icons/macrobrowser/dropdown/toc.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Table of Contents</th>
</tr>
</thead>
</table>
<p style="font-size: 13px"></p>
<h2 id="AsteriskIssueGuidelines-PurposeoftheAsteriskissuetracker" class="diff-block-context">Purpose of the Asterisk issue tracker</h2>
<p class="diff-context-placeholder" style="font-size: 13px">...</p>
<p class="diff-block-target" style="font-size: 13px">Feature requests without patches are <span class="diff-html-added" id="added-diff-1" style="font-size: 100%; background-color: #ddfade;">generally </span>not accepted through the issue tracker. Instead, they are discussed openly on the mailing lists and Asterisk IRC channels. Please read the <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Issue+Guidelines#AsteriskIssueGuidelines-Howtorequestafeature" rel="nofollow" style="color: #326ca6; text-decoration: none">"How to request a feature"</a> section of this article.</p>
<p class="diff-context-placeholder" style="font-size: 13px">...</p>
<ul class="diff-block-target">
<li style="font-size: 13px"> <strong>Information Requests</strong>: (How does X parameter work?)<br />See the forums, mailing lists, IRC channels, or this wiki. For even more information, see <a href="http://www.asterisk.org/community" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none">http://www.asterisk.org/community</a> </li>
<li style="font-size: 13px"> <strong>Support requests</strong>: (My phone doesn't register! My database connectivity doesn't work! How do I get it to work?)<br />Search and ask on the forums, mailing lists, and IRC. Again, see <a href="http://www.asterisk.org/community" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none">http://www.asterisk.org/community</a> for more information.</li>
<li style="font-size: 13px"> <strong>Random wishes and feature requests with no patch:</strong> (I want Asterisk to support <insert obscure protocol or gadget>, but I don't know how to code!)<br />See the <a href="#AsteriskIssueGuidelines-feature_request" style="color: #326ca6; text-decoration: none"><span class="diff-html-changed" id="changed-diff-0" style="background-color: #d6f0ff;">How to request a feature section</span></a><span class="diff-html-changed" style="background-color: #d6f0ff;"> </span>for more information on requesting a feature.</li>
<li style="font-size: 13px"> <strong>Business development requests</strong> (I will pay you to make Asterisk support fancy unicorn protocol!)<br />Please head to the asterisk-biz mailing list at <a href="http://lists.digium.com" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none">http://lists.digium.com</a>. If what you want is a specific feature or bug fixed, you may want to consider <a class="confluence-link unresolved" href="#" style="color: #326ca6; text-decoration: none">requesting a bug bounty</a>.</li>
</ul>
<h4 id="AsteriskIssueGuidelines-Whyshouldyoureadthis%3F" class="diff-block-context">Why should you read this?</h4>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" id="removed-diff-0" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">To get the attention of helpful individuals and the Asterisk development team, you'll want to read, understand and act on this article. </span>The steps here will help you provide all the information the Asterisk team needs to solve your issue. Issues with clear, accurate, and complete information are often solved much faster than issues lacking the necessary information.</p>
<h2 id="AsteriskIssueGuidelines-Howtoreportabug" class="diff-block-target diff-block-context"> <span class="diff-html-removed" id="removed-diff-1" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">How to report a bug</span> </h2>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> </p>
<table class="diff-macro bodyless diff-html-added" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;margin: 5px 0; padding: 0; width: auto;background-color: #ddfade;border-color: #93c49f;">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;; font-size: 13px"><span class="diff-html-added" id="added-diff-2" style="font-size: 100%; background-color: #ddfade;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB-1988229788/4252/6ac85e9b14675c5514a674e1aecae99c9505ed36.48/_/images/icons/macrobrowser/dropdown/anchor.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Anchor</span></th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; font-size: 13px">
<table>
<tbody>
<tr>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; font-size: 13px"></td>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; font-size: 13px"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">bug_report_checklist</span></td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
</table>
<p style="font-size: 13px"></p>
<h2 id="AsteriskIssueGuidelines-BugReportingCheckList" class="diff-block-target diff-block-context"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Bug Reporting Check List</span> </h2>
<table class="diff-macro diff-block-target diff-block-context" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;; font-size: 13px"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB-1988229788/4252/6ac85e9b14675c5514a674e1aecae99c9505ed36.48/_/images/icons/macrobrowser/dropdown/warning.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Warning</th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; font-size: 13px">
<table>
<tbody>
<tr>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; font-size: 13px">title</td>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; font-size: 13px"><span class="diff-html-removed" id="removed-diff-2" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">STOP! BEFORE YOU EVEN THINK ABOUT FILING A BUG REPORT</span><span class="diff-html-added" id="added-diff-3" style="font-size: 100%; background-color: #ddfade;">Before filing a but report</span>...</td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; font-size: 13px"> <p style="font-size: 13px">Your issue may not be a bug or could have been fixed already. Run through the check list below to verify you have done your due diligence.</p> </td>
</tr>
</tbody>
</table>
<h3 id="AsteriskIssueGuidelines-BugReportingCheckList" class="diff-block-target"> <span class="diff-html-removed" id="removed-diff-3" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Bug Reporting Check List</span> </h3>
<ul class="diff-block-context">
<li style="font-size: 13px"> <strong>Are</strong><strong> you reporting a suspected security vulnerability?</strong> <br />Please stop! The issue tracker is public, and once a security vulnerability is made public on the issue tracker, all users of Asterisk are made vulnerable. Please see <a class="confluence-link unresolved" href="#" style="color: #326ca6; text-decoration: none">Asterisk Security Vulnerabilities</a> for more information on reporting a suspected security vulnerability.</li>
<li style="font-size: 13px"> <strong>Are you are on a supported version of Asterisk?</strong> <br />See the <a class="confluence-link unresolved" href="#" style="color: #326ca6; text-decoration: none">Asterisk Versions</a> page for the currently supported versions of Asterisk. Bugs reported against versions of Asterisk that are no longer supported will be closed, and you will be asked to reproduce the issue against a supported version.</li>
<li style="font-size: 13px"> <strong>Are you using the latest version of your Asterisk branch?</strong> <br />Please check the release notes for newer versions of Asterisk to see if there is a potential fix for your issue. Even if you can't identify a fix in a newer version, it is preferable that you upgrade when reasonable to do so. Release notes are available in the UPGRADE.txt, CHANGES and ChangeLog files within the root directory of your particular release, and are also available at <a href="http://downloads.asterisk.org/pub/telephony/asterisk/" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none">http://downloads.asterisk.org/pub/telephony/asterisk/</a> </li>
<li style="font-size: 13px"> <strong>Are you using the latest third party software, firmware, model, etc?</strong> <br />If the error scenario involves phones, third party databases or other software, be sure it is all up to date and check their documentation.</li>
<li style="font-size: 13px"> <strong>Have you asked for help in the community? (mailing lists, IRC, forums)</strong> <br />You can locate all these services here: <a href="http://www.asterisk.org/community" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none">http://www.asterisk.org/community</a> </li>
<li style="font-size: 13px"> <strong>Have you searched the Asterisk documentation in case this behavior is expected?</strong> <br />Search the <a class="confluence-link unresolved" href="#" style="color: #326ca6; text-decoration: none">Asterisk wiki</a> for the problem or messages you are experiencing.</li>
<li style="font-size: 13px"> <strong>Have you searched the Asterisk bug tracker to see if an issue is already filed for this potential bug?</strong> <br />Search the <a href="https://issues.asterisk.org/jira" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none">Asterisk issue tracker</a> for the issue you are seeing. You can search for issues by selecting <strong>Issues -> Search for Issues</strong> in the top menu bar.</li>
<li style="font-size: 13px"> <strong>Can you reproduce the problem?</strong> <br />Problems that can't be reproduced can often be difficult to solve, and your issue may be closed if you or the bug marshals cannot reproduce the problem. If you can't find a way to simulate or reproduce the issue, then it is advisable to configure your system such that it is <a class="confluence-link unresolved" href="#" style="color: #326ca6; text-decoration: none">capturing relevant debug</a> during the times failure occurs. Yes, that could mean running debug for days or weeks if necessary.</li>
</ul>
<p class="diff-context-placeholder" style="font-size: 13px">...</p>
<ul class="diff-block-context">
<li style="font-size: 13px">Specific: Pertaining to a certain, clearly defined issue with data to provide evidence of said issue</li>
<li style="font-size: 13px">Reproducible: Not random - you have some idea when this issue occurs and how to make it happen again</li>
<li style="font-size: 13px">Concise: Brief but comprehensive. Don't provide an essay on what you think is wrong. Provide only the facts and debug output that supports them.</li>
</ul>
<h2 id="AsteriskIssueGuidelines-Submittingthebugreport" class="diff-block-target diff-block-context"> <span class="diff-html-changed" id="changed-diff-1" style="background-color: #d6f0ff;">Submitting the bug report</span> </h2>
<p class="diff-context-placeholder" style="font-size: 13px">...</p>
<h2 id="AsteriskIssueGuidelines-Submittingthebugreport" class="diff-block-target diff-block-context"></h2>
<p class="diff-block-context" style="font-size: 13px">You'll report the issue through the tracker (<a href="https://issues.asterisk.org/jira" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none">https://issues.asterisk.org/jira</a>), under the <a href="https://issues.asterisk.org/jira/browse/ASTERISK" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none">ASTERISK</a> project.</p>
<p class="diff-context-placeholder" style="font-size: 13px">...</p>
<h4 id="AsteriskIssueGuidelines-Howyoucanspeedupbugresolution" class="diff-block-context">How you can speed up bug resolution</h4>
<p class="diff-block-target" style="font-size: 13px">Follow the <a href="#AsteriskIssueGuidelines-bug_report_checklist" style="color: #326ca6; text-decoration: none"><span class="diff-html-changed" id="changed-diff-3" style="background-color: #d6f0ff;">checklist</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span><span class="diff-html-removed" id="removed-diff-5" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">above </span>and include all information that <span class="diff-html-removed" id="removed-diff-6" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">we </span><span class="diff-html-added" id="added-diff-4" style="font-size: 100%; background-color: #ddfade;">bug marshals </span>require. Watch for emails where <span class="diff-html-removed" id="removed-diff-7" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">we </span><span class="diff-html-added" id="added-diff-5" style="font-size: 100%; background-color: #ddfade;">a bug marshal </span>may ask for additional data and help <span class="diff-html-removed" id="removed-diff-8" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">us test </span><span class="diff-html-added" id="added-diff-6" style="font-size: 100%; background-color: #ddfade;">the developers by testing </span>any patches or possible fixes for the issue. <span class="diff-html-removed" id="removed-diff-9" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">If you didn't follow the information requirements - it'll often be the first thing we ask for. </span>A developer <strong>cannot</strong> fix your issue until <span class="diff-html-removed" id="removed-diff-10" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">we </span><span class="diff-html-added" id="added-diff-7" style="font-size: 100%; background-color: #ddfade;">they </span>have sufficient data to <span class="diff-html-removed" id="removed-diff-11" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">verify the </span><span class="diff-html-added" id="added-diff-8" style="font-size: 100%; background-color: #ddfade;">reproduce - or at the very least understand - the </span>problem.</p>
<h4 id="AsteriskIssueGuidelines-Reasonsyourreportmaybeclosedwithoutresolution" class="diff-block-context">Reasons your report may be closed without resolution</h4>
<p class="diff-block-target diff-block-context" style="font-size: 13px">If your bug<span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span><span class="diff-html-removed" id="removed-diff-12" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">is determined to be a configuration error or something that is clearly not reproducible, </span><span class="diff-html-added" id="added-diff-9" style="font-size: 100%; background-color: #ddfade;">:</span> </p>
<ul class="diff-block-target diff-block-context">
<li style="font-size: 13px"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Is solely the result of a configuration error</span> </li>
<li style="font-size: 13px"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Is a request for Asterisk support</span> </li>
<li style="font-size: 13px"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Has incomplete information</span> </li>
<li style="font-size: 13px"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Cannot be reproduced</span> </li>
</ul>
<p class="diff-block-context" style="font-size: 13px">it may be closed immediately by a bug marshal. If you believe this to be in error, please comment on the issue with the reason why you feel the issue is still a bug. You may also contact bug marshals directly in the #asterisk-bugs IRC channel. If that fails, bring it up on the mailing list(s) and it will be sorted out by the community.</p>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" id="removed-diff-13" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Common reasons your issue may be closed without resolution:</span> </p>
<ul class="diff-block-target diff-block-context">
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The issue can't be reproduced from the original report.</span> </li>
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The report lacks sufficient information to investigate, and you haven't responded to our requests for specific information.</span> </li>
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The issue may exist, but can't be fixed due to underlying architecture or infrastructure issues.</span> </li>
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The issue is not a bug, but is a support request. The reporter will be directed to community resources for support.</span> </li>
</ul>
<h4 id="AsteriskIssueGuidelines-WorkingwithBugMarshals" class="diff-block-target diff-block-context"> <span class="diff-html-added" id="added-diff-10" style="font-size: 100%; background-color: #ddfade;">Working with Bug Marshals</span> </h4>
<p class="diff-block-context" style="font-size: 13px">If insufficient commentary or debug information was given in the ticket then bug marshals will request additional information from the reporter. If there are questions posted as follow-ups to your bug or patch, please try to answer them - the system automatically sends email to you for every update on a bug you reported. If the original reporter of the patch/bug does not reply within some period of time (usually 14 days) and there are outstanding questions, the bug/patch may get closed out, which would be unfortunate. The developers have a lot on their plate and only so much time to spend managing inactive issues with insufficient information.</p>
<p class="diff-context-placeholder" style="font-size: 13px">...</p>
<p class="diff-block-target diff-block-context" style="font-size: 13px">If you really need the feature, but are not a programmer, you'll need to find someone else to write the code for you. <span class="diff-html-removed" id="removed-diff-14" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">However just writing a patch doesn't guarantee it'll make it into an Asterisk release. See the paragraphs below on Patch and Code submission.</span> </p>
<h4 id="AsteriskIssueGuidelines-Doyouhaveafeaturerequestandapatchtogowithit%3F" class="diff-block-target diff-block-context"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Do you have a feature request and a patch to go with it?</span> </h4>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Great, then move on to the Patch and Code submission section below.</span> </p>
<h2 id="AsteriskIssueGuidelines-PatchandCodesubmission" class="diff-block-target diff-block-context"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Patch and Code submission</span> </h2>
<ol class="diff-block-target diff-block-context">
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Make sure your patch conforms to the Asterisk project </span><a href="https://wiki.asterisk.org/wiki/display/AST/Coding+Guidelines" rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">coding guidelines</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">.</span> </li>
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Create a new issue in JIRA, the </span><a href="https://issues.asterisk.org" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Asterisk issue tracker</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">. Follow the previous guidelines when making your issue.</span>
<ul>
<li style="font-size: 13px"> <p style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">If your patch fixes a Bug, select the issue type as "Bug".</span> </p> </li>
<li style="font-size: 13px"> <p style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">If your patch is a new feature or improves an existing one, select the issue type as "Improvement" or "New Feature".</span> </p>
<table class="diff-macro diff-html-removed" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ffe7e7;border-color: #df9898;">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;; font-size: 13px"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB-1988229788/4252/6ac85e9b14675c5514a674e1aecae99c9505ed36.48/_/images/icons/macrobrowser/dropdown/tip.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Tip</span></th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; font-size: 13px"> <p style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Bugs are fixed first in the oldest release branch that contains the bug. New features and improvements should be written against Asterisk trunk.</span> </p> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Sign a </span><a href="/wiki/display/AST/Asterisk+Issue+Guidelines#AsteriskIssueGuidelines-digium_license_agreement" style="color: #326ca6; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">license contributor agreement</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> in JIRA.</span> </li>
<li style="font-size: 13px"> <p style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Attach your patch to the issue in unified diff format. Please be sure to mark the patch as a code contribution.</span> </p>
<table class="diff-macro diff-html-removed" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ffe7e7;border-color: #df9898;">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;; font-size: 13px"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB-1988229788/4252/6ac85e9b14675c5514a674e1aecae99c9505ed36.48/_/images/icons/macrobrowser/dropdown/tip.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Tip</span></th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; font-size: 13px">
<table>
<tbody>
<tr>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; font-size: 13px"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">title</span></td>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; font-size: 13px"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Format of Patch</span></td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; font-size: 13px"> <p style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Patches are most easily generated using "diff -u" or "svn diff".</span> </p> </td>
</tr>
</tbody>
</table> </li>
</ol>
<h4 id="AsteriskIssueGuidelines-FeaturesandImprovements" class="diff-block-target diff-block-context"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Features and Improvements</span> </h4>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">We all love new features, but new features bring new complexities, and new complexities bring new bugs. So, to help cut down on new bugs being introduced with your new features, please consider as much of what you're touching as possible. In other words: everything is linked in very subtle ways; make sure you look very closely at each piece of what your patch influences before you submit it. Don't be afraid to submit revised copies of the patch if that's what's required. Bug marshals are there to help you and their suggestions are based on their experience of working with Asterisk.</span> </p>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Once you have a patch that follows the requirements noted above then you can post it on the </span><a href="http://issues.asterisk.org/jira" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">issue tracker</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> in the Asterisk project as type "Improvement" or "New Feature".</span> </p>
<h4 id="AsteriskIssueGuidelines-Patchtesting%26Reviewboard" class="diff-block-target diff-block-context"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Patch testing & Review board</span> </h4>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">After you create a new feature or bug patch submission, it will need to be tested before it can be committed to the SVN repository. By "tested", we mean that multiple persons other than yourself should patch/run/abuse the patch in various manners so that all possible variations of input/output are run through the test. In instances where there are limited test environments, please document exactly how and why you were unable to get others to test the patch so that the developers know that this simply isn't "waiting for testing" and is in fact ready to go. Insufficient testing is a sure way to have your feature put on the back burner - the SVN maintainers don't have time to run exhaustive tests on each new feature. Find people on the #asterisk or #asterisk-dev IRC channels who may be able to assist you in testing, and develop a working relationship with other Asterisk users so that you can swap testing routines; this greatly speeds the process. Mail the </span><a href="http://www.asterisk.org/community/discuss" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">mailing lists</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">, informing other Asterisk users about your patch and ask for feedback.</span> </p>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">If you have submitted code in the past and are great at following the coding guidelines, then you may want to request access to Review Board. </span><a href="https://wiki.asterisk.org/wiki/display/AST/Reviewboard+Usage" rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">You can find the instructions for review board here.</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> Code submitted to Review Board is likely to be included much faster than an untested patch just sitting in the tracker. The development team will provide access to Review Board for those that submit code often, write quality code and have a history of following the coding guidelines.</span> </p>
<h4 id="AsteriskIssueGuidelines-WhocommitsthecodeintoAsterisk%3F" class="diff-block-target diff-block-context"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Who commits the code into Asterisk?</span> </h4>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">There are two ways code gets pushed into Asterisk.</span> </p>
<ol class="diff-block-target diff-block-context">
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Patches can always be merged by a member of the Asterisk Developer Community. Folks with commit access are those who have shown a willingness to work with the review process and are trusted shepherds of the project. Anyone with commit access can take ownership of a proposed patch and work to get it included in trunk - hence why the asterisk-dev </span><a href="http://www.asterisk.org/community/discuss" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">mailing list</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> is the best place to discuss patches.</span> </li>
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Digium works through the queue of all issues on the tracker, both bugs and improvements. There's typically hundreds of issues in the backlog, including the work that the Asterisk Developer Community commits to at </span><a class="confluence-link unresolved" href="#" style="color: #326ca6; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">AstriDevCon</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> every year. As such, we try to address as much as we can but there's no guarantee that we will get to any one issue.</span> </li>
</ol>
<h4 id="AsteriskIssueGuidelines-Whatisthestatusofmyissue%3F" class="diff-block-target diff-block-context"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">What is the status of my issue?</span> </h4>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The status of all issues in the tracker are reflected in the tracker. </span><span class="diff-html-added" id="added-diff-11" style="font-size: 100%; background-color: #ddfade;">Luckily, there are many talented Asterisk developers out there that can be contacted on the </span><a href="http://lists.digium.com" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">asterisk-biz</span></a><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> mailing list. You can also offer a bounty for a bug or new feature - see </span><a class="confluence-link unresolved" href="#" style="color: #326ca6; text-decoration: none"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Asterisk Bug Bounties</span></a><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> for more information.</span> </p>
<h2 id="AsteriskIssueGuidelines-PatchandCodeSubmission" class="diff-block-target diff-block-context"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Patch and Code Submission</span> </h2>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Patches for all issues are always welcome. Issues with patches are typically resolved much faster than those without. Please see the </span><a class="confluence-link unresolved" href="#" style="color: #326ca6; text-decoration: none"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Patch Contribution Process</span></a><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> for information on submitting a patch to the Asterisk project.</span> </p>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">For information on writing a new feature for Asterisk, please see the </span><a class="confluence-link unresolved" href="#" style="color: #326ca6; text-decoration: none"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">New Feature Guidelines</span></a><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">.</span> </p>
<h2 id="AsteriskIssueGuidelines-IssueLifetime" class="diff-block-target diff-block-context"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Issue Lifetime</span> </h2>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">The status of all issues in the tracker are reflected in the tracker. As issues are worked, they will move through several statuses. Issues that are "Closed" or "Complete" will have a disposition that determines their resolution. Issues with a disposition of "Fixed" have been committed to the project and will be released in the next bug fix release for all supported releases of Asterisk.</span> </p>
<p class="diff-block-context" style="font-size: 13px">For any particular issue you'll want to look at the "Status" field and the comments tab under "Activity".</p>
<div class="table-wrap diff-block-context">
<table class="confluenceTable" style="border-collapse: collapse; border: 1px solid #ddd;">
<tbody>
<tr>
<th class="confluenceTh" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;background-color: #F0F0F0; font-weight: bold;; font-size: 13px">Status Field Value</th>
<th class="confluenceTh" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;background-color: #F0F0F0; font-weight: bold;; font-size: 13px">Meaning</th>
</tr>
<tr>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; font-size: 13px">Triage</td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; font-size: 13px"> <p style="font-size: 13px">The issue has not been acknowledged yet. First a bug marshal needs to verify it's a valid report. Check the comments!</p> </td>
</tr>
<tr>
<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; font-size: 13px">Open\Reopened</td>
<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; font-size: 13px">Issue has been acknowledged and is waiting for a developer to take it on. Typically we can't provide an ETA for development<br />as priorities are complex and change constantly.</td>
</tr>
<tr>
<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; font-size: 13px">In Progress</td>
<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; font-size: 13px">A developer is working on this issue. Check the comments!</td>
</tr>
<tr>
<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; font-size: 13px">Waiting for Feedback</td>
<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; font-size: 13px">Check the comments. This issue is waiting on the "Assignee" to provide feedback needed for it to move forward.<br />Once feedback is provided you need to click "Send Back".</td>
</tr>
<tr>
<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; font-size: 13px">Closed</td>
<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; font-size: 13px">Issue has been closed. Check the "Resolution" field for further information.</td>
</tr>
<tr>
<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; font-size: 13px">Complete</td>
<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; font-size: 13px">The intended resolution was reached, but additional tasks may remain before the issue can be completely closed out.</td>
</tr>
</tbody>
</table>
</div>
<h2 id="AsteriskIssueGuidelines-FrequentlyAskedQuestions" class="diff-block-target diff-block-context"> <span class="diff-html-added" id="added-diff-12" style="font-size: 100%; background-color: #ddfade;">Frequently Asked Questions</span> </h2>
<h4 id="AsteriskIssueGuidelines-HowcanIbenotifiedwhenanissue%27sstatuschanges%3F" class="diff-block-target diff-block-context"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">How can I be notified when an issue's status changes?</span> </h4>
<p class="diff-block-context" style="font-size: 13px"> <strong>Watch an issue:</strong> You can receive E-mails whenever an issue is updated. You'll see a "watch" link on the actual JIRA issue, click that!</p>
<p class="diff-context-placeholder" style="font-size: 13px">...</p>
<p class="diff-block-target diff-block-context" style="font-size: 13px">You can safely ignore the issues starting with SWP. Digium has a whole group of developers dedicated to working on Asterisk open source issues. They use a separate project for internal time tracking <span class="diff-html-added" id="added-diff-13" style="font-size: 100%; background-color: #ddfade;">purposes only </span>to avoid cluttering up the main project. <span class="diff-html-removed" id="removed-diff-15" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span>The clone being created does not indicate any particular status<span class="diff-html-removed" id="removed-diff-16" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">.All comments</span>, <span class="diff-html-removed" id="removed-diff-17" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">work, and anything of relevance </span><span class="diff-html-added" id="added-diff-14" style="font-size: 100%; background-color: #ddfade;">and any updates </span>to the <span class="diff-html-removed" id="removed-diff-18" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">patch or issue is done </span><span class="diff-html-added" id="added-diff-15" style="font-size: 100%; background-color: #ddfade;">issue will be made </span>in the ASTERISK project</p>
<h4 id="AsteriskIssueGuidelines-WhydidmyfeaturenotmakeitintoAsterisk%3F" class="diff-block-target diff-block-context"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Why did my feature not make it into Asterisk?</span> </h4>
<p class="diff-context-placeholder" style="font-size: 13px">...</p>
<h2 id="AsteriskIssueGuidelines-DigiumSubmissionLicenseAgreement" class="diff-block-target diff-block-context"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Digium Submission License Agreement</span> </h2>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">If you are going to contribute code to the Asterisk project, then please thoroughly read and then electronically sign the </span><a href="https://issues.asterisk.org/jira/secure/DigiumLicense.jspa" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Digium Open Source Software Project Submission Agreement</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> upon logging in to the </span><a href="https://issues.asterisk.org/jira" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Asterisk issue tracker</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">. You'll see a "Sign a License Agreement" link at the top of the JIRA interface.</span> </p>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The gist of the agreement is that your contribution must not introduce any encumbrance to the Asterisk code base; Digium does not own your contribution, and they cannot take released Asterisk out of GPL. Relax; it's a very fair and reasonable license, and does not remove your rights or threaten the open source nature of the project. See the mailing list archives for long explanations of why everyone who contributes agrees that it's a fair and sane thing to do. You only need to sign the agreement once; it applies to all code that you send in via the issue tracker.</span> </p>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The issue tracker keeps a record of contributions and the license agreements that were in effect when those contributions were uploaded; it will currently restrict you from uploading a patch or documentation without a signed license agreement.</span> </p>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">How to properly upload an attachment that requires a Submission License Agreement:</span> </p>
<ul class="diff-block-target diff-block-context">
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">When using the "Attach Files" form on a particular issue, be sure to select the "Yes, this is a code or documentation contribution" radio button.</span> </li>
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">If you don't have a user license agreement, you'll see the message</span> <br /> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> " You dont appear to have a current, signed submission license agreement on file. Please sign one before attempting to upload a code or documentation contribution."</span> </li>
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">To sign a submission license agreement, use the "Sign a license Agreement" link at the top navigation bar in JIRA.</span> </li>
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The license agreement will be reviewed by Digium's legal department, then you'll be notified by E-mail of acceptance or rejection. If accepted you can now repeat the upload process and you'll be able to upload the code with a proper license associated to your account and showing by the attachment.</span> </li>
</ul>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">If you upload a patch and do not mark it as a code submission, and a bug marshal or developer later determines it to be a code submission, they may have to delete your patch and ask you to re-upload it, properly marking it as a code submission so that your license will be associated.</span> </p>
<h3 id="AsteriskIssueGuidelines-MultipleAuthorsofaSinglePatch" class="diff-block-target diff-block-context"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Multiple Authors of a Single Patch</span> </h3>
<ul class="diff-block-target diff-block-context">
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">If you are the sole author of your patch, read and sign the </span><a href="https://issues.asterisk.org/jira/secure/DigiumLicense.jspa" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">agreement</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> (Digium Submission License Agreement), then submit your patch.</span> </li>
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">If there are multiple authors, all part of a single organization or corporate entity, then the representative of that entity, with that entity's permission may sign the agreement and submit the patch.</span> </li>
<li style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">If the patch has multiple authors, not part of a single organization or corporate entity, then all authors must sign the agreement and then either submit the patch or comment on the issue stating that they also provide and acknowledge the submission.</span> </li>
</ul>
<h2 id="AsteriskIssueGuidelines-GetinvolvedinAsteriskDevelopment-influencethefutureofAsterisk" class="diff-block-target diff-block-context"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Get involved in Asterisk Development - influence the future of Asterisk</span> </h2>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Reading the guidelines here is a great start! There are plenty of other wiki pages on </span><a href="https://wiki.asterisk.org/wiki/display/AST/Development" rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Asterisk development which include coding guidelines</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">. Feel free to start submitting relevant patches, documentation additions or fixes as soon as you can. There are many minor features and changes that need to be tested, reviewed and possibly expanded or tweaked before they can go into Asterisk.</span> </p>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Start associating with other Asterisk developers where they hang out </span><a href="http://www.asterisk.org/community/" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">http://www.asterisk.org/community/</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">. You'll find them on primarily on IRC and the mailing lists. The forums are populated primarily by users.</span> </p>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Once you get to know the community and you really want to influence the Asterisk road-map, you'll want to check out AstriDevCon. AstriDevCon is an event held alongside </span><a href="http://www.astricon.net" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">AstriCon </span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">where the developers get together to review what was done in the past year and plan Asterisk's future.</span> </p>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-added" id="added-diff-16" style="font-size: 100%; background-color: #ddfade;">.</span> </p>
<h4 id="AsteriskIssueGuidelines-HowcanIspeedupmyissueresolution%3F" class="diff-block-target diff-block-context"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">How can I speed up my issue resolution?</span> </h4>
<ol class="diff-block-target diff-block-context">
<li style="font-size: 13px"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Follow the guidelines on this patch! Having good, accurate information that helps bug marshals reproduce the issue typically leads to much faster issue resolution.</span> </li>
<li style="font-size: 13px"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Provide a patch! Issues with patches are also generally resolved much faster. If you can't write a patch, there are many smart, talented developers in the Asterisk community who may be worth helping you. You can contract with them on the </span><a href="http://lists.digium.com" class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">asterisk-biz</span></a><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> mailing list, or offer a </span><a class="confluence-link unresolved" href="#" style="color: #326ca6; text-decoration: none"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">bug bounty</span></a><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">.</span> </li>
</ol>
<p class="diff-block-target diff-block-context" style="font-size: 13px"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span> </p>
</div>
</div>
</div>
<table id="email-actions" class="email-metadata" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-top: 1px solid #bbb; color: #505050; margin: 8px 0 0 0; padding: 0; color: #505050">
<tbody>
<tr>
<td class="left" valign="top" style="font-size: 13px; padding-top: 8px; max-width: 45%; text-align: left"> <span class="email-list-item"><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Issue+Guidelines" style="color: #326ca6; text-decoration: none">View Online</a> </span> <span class="email-list-divider" style="color: #505050; padding: 0 0.350em">·</span> <span class="email-list-item"><a href="https://wiki.asterisk.org/wiki/plugins/likes/like.action?contentId=19726406" style="color: #326ca6; text-decoration: none">Like</a> </span> <span class="email-list-divider" style="color: #505050; padding: 0 0.350em">·</span> <span class="email-list-item"><a href="https://wiki.asterisk.org/wiki/pages/diffpagesbyversion.action?pageId=19726406&revisedVersion=49&originalVersion=48" style="color: #326ca6; text-decoration: none">View Changes</a> </span> <span class="email-list-divider" style="color: #505050; padding: 0 0.350em">·</span> <span class="email-list-item"><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Issue+Guidelines?showComments=true&showCommentArea=true#addcomment" style="color: #326ca6; text-decoration: none">Add Comment</a> </span> </td>
<td class="right" width="50%" valign="top" style="font-size: 13px; padding-top: 8px; text-align: right"> <span class="email-list-item"><a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST" style="color: #326ca6; text-decoration: none">Stop watching space</a> </span> <span class="email-list-divider" style="color: #505050; padding: 0 0.350em">·</span> <span class="email-list-item"><a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action" style="color: #326ca6; text-decoration: none">Manage Notifications</a> </span> </td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
</table> </td>
</tr>
<tr>
<td id="email-footer" align="center" style="font-size: 13px; padding: 0 16px 32px 16px; margin: 0"> <small style="font-size: 11px"> This message was sent by <a class="email-footer-link" style="color:#505050;font-size:11px;text-decoration:none;; color: #326ca6; text-decoration: none; color: #505050; font-size: 11px" href="http://www.atlassian.com/software/confluence">Atlassian Confluence</a> 5.1.5, <a class="email-footer-link" style="color:#505050;font-size:11px;text-decoration:none;; color: #326ca6; text-decoration: none; color: #505050; font-size: 11px" href="http://www.atlassian.com/software/confluence/overview/team-collaboration-software?utm_source=email-footer">Team Collaboration Software</a> </small> </td>
</tr>
</tbody>
</table>
</body>
</html>