Filing a bug report

Apache NetBeans Wiki Index

Note: These pages are being reviewed.

If you think you have found a bug in the NetBeans Platform or IDE which affects your module development, please file it so it can be fixed. Generally exceptions coming from platform code are bugs in NetBeans (unless it is e.g. an IllegalArgumentException thrown after your code called a method with invalid arguments). Other things can of course be bugs if NetBeans is not behaving according to its documentation, or if something just looks wrong.

  1. Reread all relevant documentation to see if you have missed anything important.

    1. If you are unsure whether the behavior is really incorrect, you can ask on dev@platform.netbeans.org. Do not be too shy to file a bug, though; it is just as easy to close an invalid bug report as it is to reply to the mailing list.

    2. If at all possible, figure out how to reproduce your bug. From scratch: the assignee of the bug report cannot see your computer and has no idea what you are working on or why. Try to make a minimal, self-contained test case that anyone could run to see the bug in action. Often a suite project is a good test case - attach a ZIP of sources, including nested module projects. If you know how to write a unit test for the buggy module, that is ideal, but this can require some deeper knowledge of NetBeans internals. Sometimes a bug occurs that just cannot be easily reproduced - it is still fine to file a bug, but include as much diagnostic information as you can and do not be surprised if it does not get fixed.

    3. Read: Issue Reporting Guidelines

    4. For general background you may also want to read: How To Ask Questions The Smart Way

    5. File a bug report and include at least

    6. Some background on what you are trying to accomplish and why.

    7. Some kind of test case to demonstrate the bug.

    8. Instructions for running the test case.

    9. What you would expect to see happen.

    10. What you actually see happen.

    11. Be patient as the bug is assigned and evaluated, and provide additional information if requested. If all goes well it should be fixed for a future NetBeans release. The evaluator may also be able to offer some workarounds for use in current releases.