Search results

"What's Next?" -- A Nice Way to End Help Topics

by Tom Johnson on Jun 28, 2008
categories: technical-writing

At the end of many topics in Flare's help, a What's Next? section appears. For example, in a topic on Creating a Table of Contents, the What's Next? feature guesses what you'll want to do next -- enable the table of contents in your target. See the following image.

Having used Flare's help for a while, I really like this What's Next? feature. For me, it works better than the See Also references, which are more common. (One time I asked a user why he never clicked the See Also link as he was looking for information. He said, "I've clicked it before in other help systems and it was never helpful, so I just assumed I'd have the same experience.")

Not every topic in Flare's help has a What's Next? section at the bottom, but I wish every topic did. I'm surprised I don't see this feature in more help systems. It seems like such a logical way to end a topic.

In some ways, it helps provide transitional glue from one topic to the next. People can land anywhere in your help system, but through the What's Next? section, you can recommend where they should go next.

If you add a What's Next? section at the bottom of each topic, it might also provide a better structure for your table of contents layout. In some cases, the What's Next? topic may help you see how the table of contents should be arranged.

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.

If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.