Give enough examples! I think you'll agree that, a long document without (enough) examples, is difficult to understand, or difficult for the readers to believe that they actully got it.