Latest posts by techwriter (see all)
- Test Your Knowledge of 4 Basic Fonts – Drag & Drop - January 27, 2017
- How NOT to Design a Web Site - January 25, 2017
- Hazards of Poorly Written Technical Documentation - December 26, 2016
© Ugur Akinci
Titles and subtitles may look easy to write but there is usually a lot to design the perfect title for your technical articles and documents. And by “perfect” I mean a title that would help the end-user understand the main point of the documentation easily.
Here is a GENERAL RULE that worked for me in the past:
A title should identify right away what the article or document is all about.
Also: if possible, a title should give a sense of the importance of whatever the document is about.
“A Modern Miracle: Denver International Airport”
Obviously, this article is about Denver International Airport.
That’s why there are two things wrong with this title:
1) “Denver International Airport,” should come first, before the colon, since that’s what the article is really all about.
2) The title does not tell us why Denver International Airport is a “modern miracle.”
MUCH BETTER: “Denver International Airport: the Only Airport in the World Built with the Miraculous XYZ Technology”
Now not only do we know what the text is all about (Denver International Airport), but also why it is important to read about it (because it is “the Only Airport in the World Built with the Miraculous XYZ Technology”).
Rewrite and improve the following title:
“Mission Impossible: Apollo 13” (Google “Apollo 13” to find out what happened to it and the reasons why it could be characterized as “mission impossible.”)