I am currently blogging a series about Rules for Writing. This information was presented by Terry Wessner at Anthrocon 2009. Here is an interesting quote from Terry: "People who can make mistakes are more interesting."
You should provide the reader with all the critical pieces needed before writing about the solution in your prose. If you delay this presentation until after you have already solved the mystery, you are going to have some disgruntled readers.
Likewise you need to deal with any details you draw attention to. Note that you do not have to fully explain the details. You just need to address them. This even applies when dealing with a red herring.
Terry did not have a high opinion of Hollywood movies. He did not think they always lacked entertainment value. But he did have this to say: "Hollywood entertainment is strictly coincidental." In other words, Hollywood is out to make money. Period. If the films happen to entertain somebody, that is just happenstance.
Mysterious Double Instance Hampering Performance - I study the existing code base. Confer with a colleague. Then I determine the optimal plan to change the functionality to load only a slice of all the dat...