[larrys]

"it is important to develop it and not simply state a summary of it."

One suggestion I do have to help with readability (and with someone deciding whether they want to read the entire comment) is to place a summary (longer than a sentence) at the beginning of what you are writing if it is long and detailed.

I've found that this practice is helpful not only when writing to customers, but when writing to "important people" who most likely aren't going to want to take the time to read an entire detailed CYA type email with my opinion on something they have asked me about. That way if they want, they can dig further. And if anything happens it's on them if they did not read the fine print and only followed the summary to make a decision.