Law 2B: The more you have to explain it, the more you probably have it wrong - page 1

If it takes more than a couple of pages to explain, keep working, it needs to get simpler!

If you can't state it in one sentence that a ten-year-old can understand, you don't have it yet.

Fundamental truths are always simple and simply expressed. Lincoln's Gettysburg address is just 10 sentences and 272 words, of which 204 are one-syllable!

This principle applies not just to the documentation, but also to the thing you are documenting!

  The more software you need to do something, the more wrong it probably is!
  The more hardware you need to do something, the more wrong it probably is!