Reporting a Bug
===============

Whenever you find a bug in Symfony2, we kindly ask you to report it. It helps
us make a better Symfony2.

.. caution::

    If you think you've found a security issue, please use the special
    :doc:`procedure <security>` instead.

Before submitting a bug:

 * Double-check the official `documentation`_ to see if you're not misusing the
   framework;

 * Ask for assistance on the `users mailing-list`_, the `forum`_, or on the
   #symfony `IRC channel`_ if you're not sure if your issue is really a bug.

If your problem definitely looks like a bug, report it using the official bug
`tracker`_ and follow some basic rules:

 * Use the title field to clearly describe the issue;

 * Describe the steps needed to reproduce the bug with short code examples
   (providing a unit test that illustrates the bug is best);

 * Give as much details as possible about your environment (OS, PHP version,
   Symfony version, enabled extensions, ...);

 * *(optional)* Attach a :doc:`patch <patches>`.

.. _documentation: http://symfony.com/doc/2.0/
.. _users mailing-list: http://groups.google.com/group/symfony-users
.. _forum: http://forum.symfony-project.org/
.. _IRC channel: irc://irc.freenode.net/symfony
.. _tracker: https://github.com/symfony/symfony/issues