Changes between Version 5 and Version 6 of WikiStart


Ignore:
Timestamp:
01/26/09 01:17:16 (16 years ago)
Author:
Valik (IP: 75.90.229.196)
Comment:

Major revamp to explain what we want and expect from users.

Legend:

Unmodified
Added
Removed
Modified
  • WikiStart

    v5 v6  
    1 = Welcome to !AutoIt Trac =
     1= Welcome to the !AutoIt issue tracker =
    22
    3 !AutoIt Trac is the new system for bug reporting and feature requests in !AutoIt.
     3The !AutoIt issue tracker is the new system for placing bug reports and feature requests for !AutoIt.  Please take a moment to read over this page and get an understanding of what you need to do in order to help the developers improve the !AutoIt language.
    44
    5 Please use the braces for source code entry in a ticket which will force plaintext:
     5== General Notes ==
     6 * Please use the following syntax when inserting code.  It helps the code stand out making it easier to read.
    67{{{
    78{{{
     
    910}}}
    1011}}}
    11 
    12 
    13 == Notes ==
    14  * "Milestone" values are purely for developer use - please do not change the milestone values yourself.  A milestone is the version that a particular bug-fix or enhancement '''will eventually be''' added to AutoIt. This may be a version that has not yet been released.
    15  * Do not keep reopening bug reports just to argue about the resolution.  Start a discussion on the forum if you must.
    16  * '''This is not the place to ask for support.  This is for bug reports and feature requests only.'''  See the [http://www.autoitscript.com/forum/index.php Autoit forum] to ask for support.
     12 * If you must post a large piece of code then please attach the file instead of posting it in-line.
     13 * When creating a ticket please do not set the Milestone value.  The Milestone value is for developer use only.  The developers set the Milestone when they close a ticket that involves some sort of modification to !AutoIt.  The Milestone the developers set is the '''future''' release of !AutoIt where the bug is fixed or the feature is added.  This may be a version that has not yet been released.
     14 * When creating a ticket please do not set the Blocking flag.  The Blocking flag is for developer use only.  The developers set the Blocking flag when they have open tickets they want to ensure are resolved before the next major release.  What gets considered for blocking is entirely up to the developers and is not subject to discussion except amongst the developers.  Don't set the Blocking flag.
     15 * Do not argue about the resolution a ticket is given unless you can prove that closing the ticket was a mistake.
     16 * '''Do not ask for support.'''  This is for bug reports and feature requests only.  See the [http://www.autoitscript.com/forum/index.php Autoit forum] to ask for support.
     17 * When creating a ticket, post '''all''' the relevant information in the ticket.  If you want to link to the forum so we can see the discussion on the issue that's fine.  But do not just link to the forum and expect us to read through a thread to find all the information.  Tickets should stand on their own and links to the forum should only contain extra and unnecessary data.
    1718[[BR]]
    18 == Bug Reporting ==
    19 === Useful Reports ===
    20  * [query:?status=accepted&status=assigned&status=new&status=reopened&order=changetime&desc=1&type=Bug&col=id&col=summary&col=owner&col=component&col=version&col=reporter&col=keywords All Open]
    21  * [query:?status=closed&groupdesc=1&group=milestone&order=changetime&milestone=%21&desc=1&resolution=Fixed&col=id&col=summary&col=component&col=version&col=reporter Fixed (by milestone)]
    22  * [query:?status=closed&type=Bug&order=changetime&desc=1&resolution=No+Bug&resolution=Rejected&resolution=Wont+Fix&resolution=Duplicate&resolution=Works+For+Me&col=id&col=summary&col=milestone&col=component&col=resolution&col=reporter NoBug/Duplicate/Won't Fix]
    23  * [query:?status=closed&order=changetime&desc=1&type=Bug&col=id&col=summary&col=milestone&col=component&col=resolution&col=reporter All Closed (by modified)]
    24 
     19== How to report bugs ==
     20The developers need a few things from you when you report a bug in order for them to diagnose and fix a bug.
     21 * A short script that reproduces the issue.  The developers don't care what you're trying to do that lead you to discover the bug.  They only care about the bug itself so show only that.
     22 * If the reproduction script requires an external program in order to replicate the bug then try to find alternatives.  Try to demonstrate the bug using an AutoIt GUI instead of an external application.  Try to favor an application that comes standard with Windows.  As a last resort try to find an easy to obtain and install application that demonstrates the issue.  The more complex it is to reproduce a bug the less likely the developers are to spend their time working on it.
     23 * Provide information about your OS.  There are differences in behavior between the various versions of Windows so always mention what version and service pack level of your OS.  It really is important.
    2524[[BR]]
    26 == Requesting New Features ==
    27 [wiki:AutoItNotOnToDoList A list of things '''not''' on the ToDo list - READ FIRST]
    28 
    29 === Useful Reports ===
    30  * [query:?status=accepted&status=assigned&status=new&status=reopened&group=priority&order=changetime&desc=1&type=Feature+Request&col=id&col=summary&col=owner&col=component&col=reporter&col=keywords All Open]
    31  * [query:?status=closed&groupdesc=1&group=milestone&order=changetime&milestone=%21&desc=1&resolution=Completed&col=id&col=summary&col=component&col=reporter Completed/Implemented (by milestone)]
    32  * [query:?status=closed&type=Feature+Request&order=changetime&desc=1&resolution=No+Bug&resolution=Rejected&resolution=Wont+Fix&resolution=Duplicate&resolution=Works+For+Me&col=id&col=summary&col=milestone&col=component&col=resolution&col=reporter Rejected]
    33  * [query:?status=closed&order=changetime&desc=1&type=Feature+Request&col=id&col=summary&col=milestone&col=component&col=resolution&col=reporter All Closed (by modified)]
     25== How to ask for new features ==
     26 * [wiki:AutoItNotOnToDoList A list of things '''not''' on the ToDo list - READ FIRST]
     27 * Seriously, go and read this [wiki:AutoItNotOnToDoList page] again.  Do not ask for these things.
     28 * When creating a feature request, please unset the version field.  The version field is not used with feature requests.  In addition the blocking and milestone fields should be left empty as well.
     29 * Think about your feature request.  If you can do it via UDFs, then don't ask for it to be built in.  There's a reason you can create your own functions.
     30 * Don't ask the developers to write UDFs.  If you want to see UDFs added then you'll need to write it or get someone else to write it and submit it with the proper documentation.
     31 * Don't assume that just because you need a feature that the majority of people will use the feature.  In other words don't ask for very niche things.  This is doubly true if you can do what you need via a UDF.  Things added to the language are intentionally very broad to reduce bloat.
     32[[BR]]
     33== Useful Reports ==
     34Here are some useful reports to take you to various types of tickets.  Unless otherwise specified these reports are sorted by the last modification date.
     35 * [query:?status=accepted&status=assigned&status=new&status=reopened&order=changetime&desc=1&type=Bug&col=id&col=summary&col=owner&col=component&col=version&col=reporter&col=keywords Open Bugs]
     36 * [query:?status=closed&groupdesc=1&group=milestone&order=changetime&milestone=%21&desc=1&resolution=Fixed&col=id&col=summary&col=component&col=version&col=reporter Fixed Bugs (Sorted by Milestone)]
     37 * [query:?status=closed&type=Bug&order=changetime&desc=1&resolution=No+Bug&resolution=Rejected&resolution=Wont+Fix&resolution=Duplicate&resolution=Works+For+Me&col=id&col=summary&col=milestone&col=component&col=resolution&col=reporter Invalid Bugs]
     38 * [query:?status=closed&order=changetime&desc=1&type=Bug&col=id&col=summary&col=milestone&col=component&col=resolution&col=reporter Closed Bugs]
     39 * [query:?status=accepted&status=assigned&status=new&status=reopened&group=priority&order=changetime&desc=1&type=Feature+Request&col=id&col=summary&col=owner&col=component&col=reporter&col=keywords Open Feature Requests]
     40 * [query:?status=closed&groupdesc=1&group=milestone&order=changetime&milestone=%21&desc=1&resolution=Completed&col=id&col=summary&col=component&col=reporter Completed Feature Requests (Sorted by Milestone)]
     41 * [query:?status=closed&type=Feature+Request&order=changetime&desc=1&resolution=No+Bug&resolution=Rejected&resolution=Wont+Fix&resolution=Duplicate&resolution=Works+For+Me&col=id&col=summary&col=milestone&col=component&col=resolution&col=reporter Rejected Feature Requests]
     42 * [query:?status=closed&order=changetime&desc=1&type=Feature+Request&col=id&col=summary&col=milestone&col=component&col=resolution&col=reporter Closed Feature Requests]