[Freeipa-devel] Improving bug reporting
Petr Vobornik
pvoborni at redhat.com
Tue May 3 16:40:05 UTC 2016
On 05/03/2016 01:45 PM, David Kupka wrote:
> Hello everyone!
>
> I often miss proper reproducer and other important info in trac tickets.
> Asking for the missing info or guessing and trying is as ineffective as
> it sounds and costs us a lot of time and effort. I believe we can
> improve that.
>
> We have guidelines for reporting a bug [1] but it obviously isn't
> enough. I propose to prefill track ticket's description with following
> (or similar) template and be strict on refusing (i.e. closing as
> invalid) tickets that are incomplete.
>
> Any thoughts, suggestions, agreement or disagreement?
>
> [1] http://www.freeipa.org/page/Troubleshooting#Reporting_bugs
>
> --8<------------- trac-ticket-template-proposal ------------------->8--
> Related SW versions:
> On server:
> {{{
> $ rpm -q freeipa-server pki-base 389-ds-base bind samba krb5-server
> certmonger
> }}}
> On client:
> {{{
> $ rpm -q freeipa-client krb5-workstation certmonger
> }}}
>
> Reproducible:
> How often the issue occurs or what special condition is required to be met.
>
> Examples:
> Always / Happened X times of Y tries / Only at noon 29th February when
> it's also Thursday / Only on Raspberry Pi
>
> Steps to reproduce:
> Precise description of all related steps you have done. List of commands
> to run is the best form.
>
> Example:
> {{{
> # ipa-server-install -a Secret123 -p Secret123 -r EXAMPLE.TEST -U
> # echo Secret123 | kinit admin
> }}}
>
>
> Actual result:
> Description of behavior you have observed (error, unexpected warning, ...).
>
> Example:
> {{{
> kinit: Client 'admin at EXAMPLE.TEST' not found in Kerberos database while
> getting initial credentials
> }}}
>
> Expected result:
> Description of behavior you have expected.
>
> Example:
> TGT for admin user is acquired.
> --8<--------------------------------------------------------------->8--
>
+1
I would also consider section "Impact". Sometimes it is not clear if the
reported just saw a error message but it works otherwise or something
doesn't not work at all. Or that an issue blocks half of integration
test suite.
--
Petr Vobornik
More information about the Freeipa-devel
mailing list