Comment by tedggh

11 days ago

Ask your team to make their documentation at least 30% shorter just before sending. I don’t remember where I first I read this advice for writing code, but it’s been part of my workflow for several years. It’s an arbitrary number, but it forces you think how to make things simpler. I apply the same principle when packing for travel or hiking.

I once ended up helping (a bit) editing a book (with chapters written by various co-workers). My main contribution was deleting whole chapters. And telling others to make it 50% as long.