Writing for the web: making a (bulleted) list

The list is one of the most important aspects of writing for the web that the writer must master. A well-formed list not only adds visual variety to the writing but aids in comprehension. The list invited the reader to scan the text, but it can offer the visual cues to arrest the eye.

Lists do not form themselves. The writer must make them happen. Here are some considerations and guidelines:

• Appropriateness and significance. Lists are fairly easy to form, but they must be appropriate to the subject matter and significant to the subject. They must help introduce new information and concepts to the reader that are due some consideration on the part of the reader.
  
  
• Number of items. A list must contain at least two items. In web journalism, the best lists are three to five items, but there is no hard rule about the number of items in a list.
  
  
• Use of boldface. A list is best used when one or two of the most important words can be boldfaced. Doing this aids the reader in finding the words with the most informational value in the list. But boldfacing should be used sparingly. If you boldface an entire item in a list, you dilute the effect of the bold type.
  
  
• Numbered and unnumbered lists. Two of the most common types of lists in HTML are the numbered and the unnumbered list. The numbered list uses numbers to introduce each item in the list. Use the numbered list when the numbers are important either for sequence or importance. When numbers are not important to the list, use the bulleted, or unnumbered, list. Numbers can be distracting if they do not carry any informational weight.
  
  
• Parallelism. Ideally, lists should be constructed so that they are parallel. That has two meanings. One, grammar constructions of all items of the list should be the same. If one is a complete sentence, all of them should be. If one is a fragment beginning with a participle, all should be.
  
  The second meaning of parallelism is that the items in a list should be of the same type or alike in a discernible way. Another way of saying this that no one item in a list should seem out of place with the other items
  
  (Parallelism is an important tool of the writer -- one that should be understood thoroughly so it can be put to good use. The concept goes beyond the explanation presented here. To learn more about parallelism, start here at the Online Writing Lab at Purdue University.)

What good is all this?

Jakob Nielsen's research group has confirmed that readers of text on a web page are likely to do so in an F-shaped pattern. The research produced the "heatmaps" shown here that indicated the hot spots on a page of text where the eye of the reader tends to stop.

Nielsen says this about the implications of this pattern:

The F pattern's implications for Web design are clear and show the importance of following the guidelines for writing for the Web instead of repurposing print content:

• Users won't read your text thoroughly in a word-by-word manner. Exhaustive reading is rare, especially when prospective customers are conducting their initial research to compile a shortlist of vendors. Yes, some people will read more, but most won't.
• The first two paragraphs must state the most important information. There's some hope that users will actually read this material, though they'll probably read more of the first paragraph than the second.
• Start subheads, paragraphs, and bullet points with information-carrying words that users will notice when scanning down the left side of your content in the final stem of their F-behavior. They'll read the third word on a line much less often than the first two words.

A well-structured list thus plays into the tendencies of the reader and gives the producer of the web page a great chance to satisfy the reader.

Audio journalism III: Teaching j-students about recording, editing and distribution

• Beginning journalism students, in their first news writing classes, should be taught the basics of audio journalism and should put those basics into practice.

The concept of audio journalism takes us beyond the medium of radio and requires that we think about sound itself as an increasingly available and important tool of the journalist (as we argued in the first two essays in this series -- see Audio journalism I and Audio journalism II).

How then do we as journalism educators train our students to use this tool?

At the University of Tennessee, we are trying to turn our curriculum more toward the web and away from the traditional media forms of print and broadcasting. This is a systemic change that will not be accomplished by simply adding one or two courses on web journalism to the curriculum or even by creating a sequence of courses. Instead, it involves changing our approach in our most basic courses.

One of those basic courses is JEM 200 Introduction to news writing. This course is required of all journalism majors as the gateway course to the journalism curriculum, and it has traditionally introduced students to the concepts of good writing, AP style, attribution, the inverted pyramid and other skills necessary for a start in journalism. We are now putting more emphasis on developing skills for writing for the web -- conciseness, headlines, summaries, lists, linking, etc. -- and in the section that was once "writing for broadcast," we are now teaching the concepts of audio journalism.

Here's what we are including:

• Audio journalism
  The importance of sound. Sound can be an excellent way to go beyond the pictures and text a reporter produces in covering a story. Sound gives voice to sources in a way that text cannot.
  Formats. We reviewed some of the formats available to audio journalists in the second post of this series. Sound can be a complement to the other reporting or it can be the dominent form of the report. The web is allowing us to develop new formats, such as the audio slide show.
  
  
• Writing for audio
  Traditional radio formats. These forms of presentation of news and information including the drama unity broadcast story structure are still important for students to learn and use.
  New forms of writing for audio that web journalism offers. We have already referred to audio slide shows, but we also must give some attention to writing introductions that alert readers as to what they are about to hear and to describe links included with the sound stories.
  Writing scripts, questions and outlines. Most of what is broadcast in traditional media begins with and follows a script. Good scripts promote the efficient presentation of news and information, and they are likely to continue to be necessary on the web.
  
  
• Speaking clearly
  Enunciation and beyond. In previous times, training in this area could generally be ignored by most journalists, particularly those going into print. No longer. Journalists now need to use their own voices. Their accent, grammar and pronunciation skills must be developed beyond the normal level of speaking. Their speaking habits must exclude the use of the word "like" after every third word, and they must speak with the confidence that allows them to drop the hesitant pauses, the "uhs" and the "you knows."
  Developing habits and practices that enhance the clarity of sound and the quality of reporting. We might jokingly call this our "radio voice," but it is no longer a joke. Journalists -- all journalists -- must be heard and understood.
  Acquiring the skill of the short, concise question. Asking well-formed, concise questions -- and then shutting up -- is a rare skill, but it is one that should be developed by all of our students.
  
  
• Recording
  Tools and equipment. Basic recording equipment is inexpensive and simple to use. Every journalism student must have some kind of ditigal recorder and must be aware of its capacity.
  The importance of sound quality. Sound quality does not have to be an obsession because of the good equipment that is available. Still, journalism students must learn to make their equipment produce clear, understandable sound on all occasions.
  Ambient sound and music. The qualities of ambient sound and music can enhance the reporting. They are special products of audio journalism that cannot be duplicated by any other medium.
  
  
• Editing
  Putting audio files together for presentation. Editing audio can be as simple or as complex as the reporter and editor choose to make it. Some audio reporters, such as NPR's science reporter Robert Krulwich, develop their stories through complex and highly sophisticated editing techniques (see Darwin's Very Bad Day, for example). Our goals for beginning journalism students are more modest. Simply producing a clear, coherent recording would be enough.
  Multiple tracks. Student should have some basic understanding of mixing sound tracks.
  Importance of beginning and ending. Writing good introductions and planning the sound story from beginning to end is basic to good audio journalism.
  Standard constructions and techniques. Students should learn the standard techniques of audio editing as the well as the terms, such as fades, cross-fading, establish music, segue, transition, voice out, music up, and voice wrap.
  

Covering these areas in just a few weeks of a writing course is ambitious. Not all of these subject will be areas in which the students can acquire any mastery, but their introduction and practice can show students their importance.

Note: I post the lecture notes for the lecture section of JEM 200, and at this writing I have posted the notes for the first of three lectures based on these essays about audio journalism. Two more sets of lecture notes are planned.

Audacity

The one piece of software that students should learn for audio journalism is Audacity.

While editing sound has a wide array of possibilities, it has been rendered simple and easy by Audacity, a free and downloadable piece of software from SourceForge.net. Audacity comes with a set of tutorials, the basics of Audacity can be grasped in just a few minutes by those who simply use the software. Audacity allows users to add and delete portions of a soundtrack and to place new soundtracks into a file. Its visual dashboard (below) includes all of the tools for basic sound editing, and it is likely that student will be able to learn the program to create audio files very quickly.



Podcasting

Podcasting is a term sometimes used for the general idea of audio journalism, but in reality it has a much more specific meaning. Podcasting is a means of distributing audio files through RSS (really simple syndication) feeds. Students should be taught the basics of using this system for distributing the audio files they produce, but we will refrain from going into details about it until a later post.

Read the two previous essays in this series on audio journalism:

Audio journalism I: Defining the field - the power and importance of sound

• A clarion call for journalism instructors to think beyond the strictures of radio and to teach audio journalism -- using sound as a reporting tool -- to all of their students.

Audio journalism II: Forms and formats

• Creative journalists can use the tool of sound as an effective in their reporting. They can start with traditional formats, but the web will allow them to develop their own.

Reforming the J-curriculum: beginning at the beginning

• To really reform a journalism curriculum, you have to begin at the beginning.

The faculty of the School of Journalism and Electronic Media at the University of Tennessee decided at its first faculty meeting of the semester in January to make some definite moves toward revising our curriculum to recognize the realities of the changing media environment and to prepare our students for those realities.

During the past few years, the UT faculty had done what other faculties have done -- lay on a couple of extra courses about web journalism. Some faculty members had made some moves within existing courses (including changing the names of the courses) to include more about the web.

We had even taken a step beyond that in starting a student-operated news web site, the Tennessee Journalist (tnjn.com), that is a central part of the curriculum. The site operates independently from any single course and thus is open to being used by all courses.

All of these were steps in the right direction, but they have not achieved the fundamental changes within the curriculum that we have sought. At our January meeting, we resolved to take a big step (bigger, I think, than even most of our faculty realized) and change JEM 200, the introductory news writing course that is required of all majors and taken by many other students as well.

Because I am the coordinator of all JEM 200 sections, the task of rethinking and re-envisioning the course has fallen to me. We offer 11 sections of the course and enroll about 200 students each semester. The sections are taught by lecturers and graduate teaching assistant and occasionally (though not this semester) by full time professors.

In our new plan for the course, the beginning six weeks of the course have not changed substantially. During those weeks we introduce students to the following topics. (The links here take you to the weekly lecture notes for each of these topics that are posted on JPROF.com.)

• Introduction to media writing
• Basic tools: Grammar and style
• Writing in the media environment
• The inverted pyramid
• Basics of reporting and journalistic writing: sources and interviewing

What came next in the old syllabus was two weeks of writing for the web. That has been expanded to four weeks. My draft proposal for how these four weeks will go follows:

Week 7, Feb. 16-20
Writing sections: continue writing in the inverted pyramid form; emphasize efficiency and conciseness. Have the students learn HTML tags with this tutorial and this exercise.
Lecture: Writing for the web I Introduction to the web | The web as a word medium | How readers use the web | Important concepts | Headlines and summaries.

Week 8: Feb. 22-26
Writing sections: Write short (no more than 200 words) but information-packed stories; introduce and practice with writing headlines and summaries using the tutorials and exercises. Assign the preview story reporting/writing assignment that will be due for next week.
Lecture: Writing for the Web II The Tennessee Journalist | Important concepts (continued) | Technology | Writing for the web - the basics | Headlines.

Week 9: March 2-6
Writing sections: Reporting assignment (preview story) due on the first section meeting; upload that assignment to the TNJN server. Practice uploading pictures and writing cutlines as well as sidebar material if possible. Look for live stories on the Tennessee Journalist to show as examples for sidebar material. Pay particular attention to the "related links" function of TNJN and have students find appropriate links for their stories.
Lecture: Writing for the Web III Inverted pyramid | Visual variety | Lists | Summaries | Microcontent | Links


Week 10: March 9-13
Writing sections: Writing assignments should include writing headlines and summaries, creating links and lists, and taking pictures and writing cutlines. A second reporting assignment -- another preview story if you don't think they're ready to do anything else -- would be good.
Lecture: Writing for the Web IV Twitter | Photojournalism | Audio | What you need to do to get ready to work in the web environment.

That will take us up to spring break. During the week after spring break, you should continue doing whatever your lab needs. One idea is to assign them to do a photo story over spring break.

After spring break, we will devote three weeks to "writing for broadcast," but that will change from the broadcast writing section that we once had.

This draft plan has been written for the lecturers and lab instructors of JEM 200, but I am posting it here on the JPROF blog so that anyone who reads it can weigh in and help us with our deliberations. I am especially interested in hearing from anyone who can suggest additional resources -- readings, tutorials, exercises, examples, etc.

Resources:

Writing headlines for the web

Basic HTML tags

Finding links

The art of linking

Writing summaries

Guidelines for the student photojournalist

Audio slide shows