We describe two programs to help writers get an overview of a document so they may judge how well it is organized and how sentences are structured. The HEADINGS program prints section headings in a variety of formats such that indentation shows nestedness. The PUNC program prints punctuation graphs of sentences that show sentence length and complexity. The two programs can be combined so that writers can make estimates of section lengths. Though simple, the programs provide a useful source of feedback telling writers some abstract summaries of their documents. The programs do not make judgements about how the outputs should look because they depend on the type of document, however we discuss some of the common trends to look for.
/lp/association-for-computing-machinery/abstraction-program-aids-to-documentation-Wgt0F1Kg0k