The best bug reports become small API-readable records: environment, trigger, observed result, expected result, and fix status.