Partager via


How to: Increase Discoverability of New Topics?

My team is discussing how we can make some new topics discoverable, so that the target readers can find them easily. We wrote these topics as complete procedures to give an overview of a complex area that is currently documented in detail, without much of an end-to-end viewpoint. The new topics will help our users put the pieces together.
Our documentation model provides for two types of procedural topics: walkthroughs and how-tos. We already have lots of walkthroughs and how-tos that cover the details in this area, so if we just add more topics of the same type, how do we signal that these are written at a different level? They could easily be lost among the 15 other topics that start with "how to" and "walkthrough."
One idea is to call them something else; basically, to create a new topic type. But then how would readers know to look for the new topic type? We could give it a flashy name like "QuickStart" or "FastTrack" that would imply an easy way to get started. But then what would happen if every time we wanted to make some topics stand out, we invented a new topic type with a flashy name? Would that help customers more easily identify what's in a topic? I don't know, maybe it would. But we already have about 17 topic types; adding more could quickly become overwhelming.
Another idea is to put the new topics into a Getting Started area. That might help users who are browsing the table of contents, but most users don't do that. The name would also have to convey what the topics are designed for, so people could identify them in a list of search results and in the index. The phrase "getting started" is already in use quite a bit in our docs, and I've seen people in usability studies go to those topics. It might be best to stay with that phrase, and use it in the topic title and perhaps the TOC too.
We're still working out the answer, but I find it an interesting discussion.