Comment by codetrotter
5 years ago
I sometimes try to follow the journalistic reporting way of writing. (Not the clickbait style mind you.)
So I start it off with a few brief paragraphs of text explaining what I did, what happened and what I expected to happen. Each paragraph only a couple of sentences long.
Then below that I fill in with more details.
Of course this still means that if you glance at it you still see a lot of text and may not bother reading. But my hope is that if by chance the recipient does read the first few paragraphs then it will provide the necessary motivation to either read on or to begin investigating on their own.
It's best to do something like
1. config and versions
2. the bug (failure to see expected results
3. how to reproduce in as simple terms as possible
4. any data such as screen shots, core dumps, logs, etc