Sunday, November 7, 2010

Working with Headings

Whether you're writing a textbook or a journal or magazine article, you're going to use headings to distinguish between sections and subsections within the content. Good headings help break up the visual appearance of the page and help visually organize the content, both of which allow the reader to focus attention on each section.

Here, then, are some basic rules for crafting effective headings for textbooks (though they can also work for many other kinds of writing).

  • No “Introduction” headings. If you’re starting to write a chapter, the first block of actual body text is by definition your introduction. You needn’t label it as such, your reader will know intuitively what it is.

  • Keep headings short. Brevity becomes increasingly important the narrower the column of the final, published piece. A heading that might look fine in a Word document with 1-inch margins might take up two or three lines in a 3-column layout.

  • Make the meaning clear. An effective heading should clearly indicate the content to come. That means: No cute headings. Cute headings might work for some magazines, absolutely, but for a textbook, they’re almost always a no-no.

  • Use parallel headings, when appropriate. Parallel headings are those that possess the same characteristics; they all start with an action verb, they’re all gerunds, they’re all one word nouns, and so forth. When you have three or four headings in a row that all relate to the same concept, make sure all those headings are parallel in format. Here’s an example:

    • Preparing mentally for tests

      • Playing private detective

      • Using practice tests to prepare





  • Never put two headings in a row without content in between. Always put some kind of content under each heading. Otherwise why have a heading?

  • Use two subheadings at a minimum beneath each heading. Think of headings as bullet points or outline items; you wouldn’t have just one bullet or one item in an outline under a heading. So don’t do it with subheadings.

  • Never assume in the first line of text that the reader has read the heading. Readers don’t expect you to refer to a heading without being explicit. For instance, let’s say your heading is “Chronic Renal Failure.” Don’t start the body text with, “This is a long-term condition....” The word This is an unclear pronoun reference in this case. Start instead with, “Chronic renal failure is a long-term condition....”

  • Don’t use a colon after a heading. Colons after a heading is redundant. Headings are typically in a larger, bolder font and thus are already set up visually as an introduction to content.

  • Avoid unnecessary articles in headings. I’m big on deleting “the” and other articles from headings. In nearly all instances they’re unnecessary, and in a heading there should be nothing that isn’t absolutely necessary.

3 comments:

  1. [...] This post was mentioned on Twitter by Andy McPhee and Andy McPhee, Andy McPhee. Andy McPhee said: Working with Headings: http://wp.me/pJ55C-a2 [...]

    ReplyDelete
  2. This is a great review for textbook authoring. I am currently editing a Core Curriculum and I wish my chapter authors followed these guidelines. Most seem to like to use colons in headings (not APA format) and start with an Introduction heading.

    Another challenge is how many paragraphs are needed to have a subheading. One of my authors used subheadings with only a couple sentences after each.

    What do you think about the use of a Summary heading for a long chapter? I can go both ways, but it seems that there needs to be a way to distinguish the closing from the prior section.

    ReplyDelete
  3. Thanks, Lorry. My authors use colons too, but I have to tell you, lots of my colleagues do too! As for paragraphs, it varies with the content and the hierarchy. For instance, if you're writing a list of diagnostic tests and their descriptions and each test is, say, a heading 3 (what we call H3; other places call them 3 heads), then a couple of sentences makes sense. There certainly should be a fair amount of content under each H1, at a minimum I'd say three paragraphs.

    For summaries, we typically design this section differently so it does indeed stand out. For the manuscript, though, I would just leave the summary head as an H1 and make it clear to design (or whomever) that the summary should be treated differently visually.

    ReplyDelete