[nabbe23]

> When done poorly, compression removes insights. When done well, compression keeps the insights and removes the rest. Compression requires both thinking and understanding, which is one reason writing is so important.

Great writing requires you to position your idea in a way that will resonate with the reader.

This is the meat and potatoes of this post to me.

I’ve been praised a bit for the usefulness and clarity in my documentation over the last few years. When people ask for my advice on improving their writing I really only give three tips.

1. Use proper grammar - proofread your doc at least 2-3 times

2. Write as if you’re writing to someone that knows absolutely nothing about the subject matter

3. Go back and compress the crap out of your document. Simplify everything, remove all fluff and simplify complex sentences. People have short attention spans, documents need to be as easy to process as possible.