Comment by temporallobe

My favorite quote from Mark Twain is “I didn’t have time to write a short letter, so I wrote a long one instead”. Indeed, brevity and clarity actually take time and analysis. I find this to be very true when writing requirements or documentation. Some of the worst requirements I’ve read have been extremely wordy and unnecessarily over-technical or jargon-heavy when it could have been explained in plain language. As usual, it very much depends on the target audience.