The art of writing bug reports, or... How to sell a movie plot? Lightning talk for DevsMeetup Freiburg in 2014 about proper bug reporting in open source projects.

1. The art of writing bug
reports, or...
How to sell a movie plot?
by Steffen Müller

2. Developer MeetUp Freiburg #8
Steffen Müller
Software Developer at
/gebrüderheitz
twitter.com/stmllr

3. Attention economy
“Attention is a tight resource.
It will hardly be granted for free.”
Developer MeetUp Freiburg #8

4. 1. Find film studios.
(the issue tracker)
Developer MeetUp Freiburg #8

5. 2. Research the market.
(duplicate issues)
Developer MeetUp Freiburg #8

6. Developer MeetUp Freiburg #8
3. Find a sweeping title
for your movie.
(the issue subject)

8. 4. Write a Log Line.
“Don’t tell the story,
sell the story”
(tl;dr)
Developer MeetUp Freiburg #8

9. Around the world in 80 days
“A bet pits a British inventor, a
Chinese thief, and a French artist on a
worldwide adventure that they can
circle the globe in 80 days.”
Developer MeetUp Freiburg #8

10. 5. Write a Screenplay.
(detailed issue description)
Developer MeetUp Freiburg #8

11. “Three acts” structure:
I. Setup
II. Confrontation
III. Resolution / Outcome
Developer MeetUp Freiburg #8

12. “Gherkin” scenario:
Given...
When...
Then...
Developer MeetUp Freiburg #8

13. 6. Create a Storyboard.
(screenshots, mockups)
Developer MeetUp Freiburg #8

14. Developer MeetUp Freiburg #8

15. 7. Stay in contact with
the studio.
(give feedback, bump issues)
Developer MeetUp Freiburg #8

16. Good luck!
Developer MeetUp Freiburg #8

17. Steps to reproduce
Developer MeetUp Freiburg #8

18. Expected result
vs.
Actual result
Developer MeetUp Freiburg #8

19. Provide Test Code
Developer MeetUp Freiburg #8

20. Isolate the issue:
Eliminate possible side effects
Developer MeetUp Freiburg #8

22. Next up:
The art of writing commit messages
Developer MeetUp Freiburg #8