# Whatis A Useful Bug Report?
       
       
       ## What Is A Bug Report?
       
       A bug report is a set of descriptive, easy to follow
       instructions(!) that let others reproduce a strange
       behaviour or an error.
       
       If it does that it is perfect(ly) enough.
       
       
       ## What Does A Bug Report Need?
       
       1. A short, comprehensible, topic related **subject line**.
       2. A description of your **expectation**.
       3. A description of your **experience**.
       4. A recipe to reproduce your steps.
       
       
       ## HOWTO
       
       ### Ask yourself:
       
       * What did you expect to happen?
       * What did happen instead?
       * How can others do what you did in order to encounter the bug?
       * Finally: what's the shortest, descriptive subject line?
       
       Write everything down. If you know how, use plain text e-mail.
       
       ### Add
       
       * Name and version of your operating system,
       * Name and version of the program/application you used,
       * Output of
         * dmesg,
         * lspci -vv,
         * lsusb.
         * Logfiles.