contact.html

   1 <!DOCTYPE HTML><!--
   2  *
   3  * contact.html
   4  *
   5  * Summary of approved methods for contacting the members of the
   6  * MinGW.OSDN user and developer community.
   7  *
   8  *
   9  * $Id$
  10  *
  11  * Written by Keith Marshall <keith@users.osdn.me>
  12  * Copyright (C) 2020, 2021, MinGW.OSDN Project
  13  *
  14  *
  15  * Redistribution and use in source and 'compiled' forms (SGML, HTML,
  16  * PDF, PostScript, RTF, etc) with or without modification, are permitted
  17  * provided that the following conditions are met:
  18  *
  19  * 1. Redistributions of source code must retain the above copyright
  20  *    notice, this list of conditions and the following disclaimer as
  21  *    the first lines of this file, unmodified.
  22  *
  23  * 2. Redistributions in compiled form (transformed to other DTDs,
  24  *    converted to PDF, PostScript, RTF and other formats) must
  25  *    reproduce the above copyright notice, this list of conditions
  26  *    and the following disclaimer in the documentation and/or other
  27  *    materials provided with the distribution.
  28  *
  29  * THIS DOCUMENTATION IS PROVIDED BY THE MINGW.OSDN PROJECT "AS IS"
  30  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
  31  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  32  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE MINGW.OSDN PROJECT, OR
  33  * ITS CONTRIBUTORS, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  34  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  35  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  36  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  37  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  38  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  39  * OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
  40  * DAMAGE.
  41  *
  42  *
  43  * Note: this page assumes browser support for the following numeric
  44  * HTML entity code:
  45  *
  46  *    &#8209;   non-breaking hyphen
  47  *    &#8220;   left (opening) typographic double quote
  48  *    &#8221;   right (closing) typographic double quote
  49  *
  50 -->
  51 <dl class="masthead"><!-- hidden for masthead class -->
  52 <!-- FIXME: is there a better way to do this?  We need to propagate
  53  content to the "as-page-title" and "as-page-subtitle" place-holders,
  54  within the "page-content" div of "index.html"; our javascript page
  55  loader will explicitly look for these hidden elements, and copy
  56  their content into the corresponding visible place-holders.
  57 -->
  58  <dt id="page-title">Contacting MinGW.OSDN</dt>
  59  <dt id="page-subtitle">When a Web-Search Fails to Resolve your Issue</dt>
  60 </dl><!-- masthead -->
  61 <p>If you have exhausted all of the web&#8209;site resources,
  62 and you have searched all of the
  63 <a href="index.html?page=mailing.html"
  64 >available mailing&#8209;list archives</a>,
  65 and all of the on&#8209;line
  66 <a rel="noopener noreferrer" target="_blank"
  67  href="https://osdn.net/projects/mingw/ticket/"
  68 >bug report and feature request tickets</a>,
  69 then you may wish to contact MinGW.OSDN for assistance.
  70 Please refer to the relevant sections below,
  71 for guidance on <a href="#general-enquiry">making general enquiries</a>,
  72 on <a href="#bug-report">filing bug reports</a>,
  73 or on <a href="#feature-request">requesting new features</a>.
  74 </p>
  75 <p><em>Please note:
  76 the mingw&#8209;w64 and MSYS2 projects are <strong>not</strong>,
  77 in any way, affiliated with MinGW.OSDN;
  78 MinGW.OSDN <strong>does not</strong> support the products
  79 of these projects.</em>
  80 </p>
  81 <div class="overlapped" id="general-enquiry">
  82 <h3>General Enquiries</h3>
  83 <p>If you encounter a problem using MinGW, or MSYS,
  84 and you cannot find a satisfactory answer on our web&#8209;site,
  85 in our
  86 <a href="index.html?page=mailing.html">mailing&#8209;list archives</a>,
  87 or elsewhere on the internet,
  88 or if you simply need some advice relating to MinGW, or MSYS,
  89 then we advise you to
  90 <a rel="noopener noreferrer" target="_blank"
  91  href="https://lists.osdn.me/mailman/listinfo/mingw-users"
  92 >subscribe to the MinGW&#8209;Users mailing&#8209;list</a>,
  93 and ask.
  94 </p>
  95 <p><em>Do please note that, to help avoid spam,
  96 this mailing&#8209;list is open to subscribers only.
  97 Please <strong>do not</strong>
  98 attempt to circumvent the subscription process,
  99 by sending mail to either the mingw-users-owner,
 100 or the mingw-users-admin addresses.
 101 Doing so will be of no benefit to you,
 102 since subscription is free&#8209;of&#8209;charge in any case,
 103 and you will get no reply from the former address,
 104 while the latter is reserved for automated self&#8209;help replies,
 105 in response to specific subject keywords.</em>
 106 </p>
 107 <p>Before posting to this mailing&#8209;list,
 108 we <em>strongly</em> recommend that you acquaint yourself with
 109 <a href="index.html?page=mailing.html#list-etiquette"
 110 >the mailing&#8209;list posting etiquette</a>;
 111 compliance with this may improve your chances of receiving a response,
 112 whereas non&#8209;compliance may result in your post being ignored.
 113 </p></div><!-- general-enquiry -->
 114 <div class="overlapped" id="bug-report">
 115 <h3>Reporting Bugs</h3>
 116 <p>After discussing an issue on the mailing&#8209;list,
 117 as described above, you may be asked to file a formal bug report.
 118 (Alternatively,
 119 if you are certain that you have identified a bug in a MinGW.OSDN product,
 120 you may choose to file such a bug report of your own volition;
 121 however, if you choose this course of action,
 122 please be aware that many bug reports,
 123 which are filed <em>without</em> prior discussion,
 124 are ultimately dismissed as user error).
 125 </p>
 126 <p><em>Before you even consider filing a bug report,
 127 please review
 128 <a rel="noopener noreferrer" target="_blank"
 129  href="https://osdn.net/projects/mingw/ticket/"
 130 >the list of existing tickets</a>,
 131 (<strong>including closed tickets</strong>
 132 &mdash; ensure that the &#8220;Open&#8221; and &#8220;Closed&#8221;
 133 status check&#8209;boxes are <strong>both</strong> selected,
 134 and click the &#8220;Search&#8221; button),
 135 to ensure that the issue has not already been reported</em>.
 136 </p>
 137 <p><em>Please <strong>do not</strong> file a bug report,
 138 if your issue relates to an unimplemented API feature;
 139 it is more appropriate to file
 140 a &#8220;<a href="#feature-request">Feature Request</a>&#8221; instead</em>.
 141 </p>
 142 <p><em>Please do not waste your time, (and ours),
 143 reporting issues with your anti&#8209;virus software;
 144 the heuristic nature of such software, all too frequently,
 145 results in false&#8209;positive reports,
 146 and in the absence of deterministic evidence of infection,
 147 we will take no action in response.</em>
 148 </p>
 149 <p>Regardless of your motivation for filing a bug report,
 150 you <em>must</em>, (unless you already have one),
 151 <em><a rel="noopener noreferrer" target="_blank"
 152  href="https://osdn.net/account/register.php"
 153 >create a personal OSDN.net account</a></em>,
 154 and you should also
 155 <em><a target="_blank" href="index.html?page=buginfo.html"
 156 >acquaint yourself with the bug reporting guidelines</a></em>.
 157 You may then
 158 <em><a rel="noopener noreferrer" target="_blank"
 159  href="https://osdn.net/account/login.php?return_to=/ticket/newticket.php?group_id=3917"
 160 >log in to your OSDN.net account</a></em>,
 161 and proceed to
 162 <em><a rel="noopener noreferrer" target="_blank"
 163  href="https://osdn.net/ticket/newticket.php?group_id=3917"
 164 >the bug report submission form</a></em>.
 165 Please review the submission instructions,
 166 (which appear at the top of the submission form),
 167 then complete the form,
 168 leaving the ticket type set to &#8220;Issue&#8221;.
 169 </p>
 170 <p><em>Please <strong>do not</strong> ignore the submission instructions.
 171 In particular, note that,
 172 unless you are a member of the MinGW.OSDN Project development team,
 173 you are <strong>not</strong> authorized to assign a specific responder
 174 for the ticket; nor are you authorized to assign an elevated priority
 175 or severity attribute for your ticket.
 176 If you exceed your authority,
 177 your ticket <strong>will</strong> be reassigned to <strong>lowest</strong>
 178 priority/severity, and may even be rejected altogether</em>.
 179 </p>
 180 <p>Before you finally submit your report,
 181 please use the &#8220;Preview&#8221; facility to check for,
 182 and correct, any markup errors;
 183 (these are, alas, all too common,
 184 and create a bad impression of the reporter).
 185 Finally, when you are satisfied, click the &#8220;Submit&#8221; button
 186 to complete the ticket submission process.
 187 </p></div><!-- bug-report -->
 188 <div class="overlapped" id="feature-request">
 189 <h3>Feature Requests</h3>
 190 <p>When you wish to request the implementation of a new feature,
 191 (e.g.&nbsp;to support a currently unsupported MSVC or POSIX API function),
 192 you should file a feature request ticket.
 193 The procedure is effectively the same as that for
 194 <a href="#bug-report">filing a bug report</a>,
 195 <em>except</em> that you set the ticket type to &#8220;Feature Request&#8221;,
 196 instead of leaving it as &#8220;Issue&#8221;.
 197 </p>
 198 <p><em>Please be aware that feature request submissions are subject
 199 to the same restrictions on your authority,
 200 as are applicable to <a href="#bug-report">bug reporting</a></em>.
 201 </p>
 202 <p>Before you submit a feature request,
 203 it is recommended that you discuss the feasibility of implementing
 204 the proposed feature, as a <a href="#general-enquiry">general enquiry topic</a>,
 205 on the mailing&#8209;list.
 206 Additionally, <em>after</em> you have submitted such a request,
 207 you should use the mailing&#8209;list to bring it to the
 208 attention of the MinGW user community,
 209 and invite them to support your request,
 210 by <em>voting</em> on your ticket;
 211 (please note that MinGW developers will consider votes,
 212 when prioritizing feature requests).
 213 </p></div><!-- feature-request -->