Do yourself and other a favor when writing an issue: explain the why.

Too often I see issues that go in detail about "what" needs to be done, but leave out the reason why it has to be done this way.

This removes any opportunity for others to reason about the proposed solution.