![\"\"](\"https:\/\/lios.dev.creationsunivers.net\/wp-content\/uploads\/2017\/04\/11_archipel_ang.jpg\")
<\/p>\nIn technical documentation, everyone knows the topic-based method is a must. But what is it exactly?<\/p>\n
<\/p>\n
Every topic should be independent. This means that when you\u2019re developing a topic, you have to thoroughly answer all questions (who, what, how, when, why). This way, every topic becomes complete in and of itself<\/b>. When topics can stand alone, they can be switched around and used in different contexts without affecting the integrity of the whole document. Imagine your documentation as a chain of islands, where every topic is an island. The subject matter is independent, but fits into the group.<\/p>\nOne need, one topic<\/h4>\n
To properly zoom in on content, the topic has to meet a need<\/b> or answer a question the user is asking, such as \u201cWhere do I start?,\u201d \u201cWhat concepts do I need to know to understand the product?,\u201d \u201cHow do I XYZ?,\u201d \u201cHow can I solve this problem?,\u201d etc. These answers will become your topics! Technically, a topic must fully answer a specific question so users find all the necessary information in one place.<\/p>\nLike every page is the first<\/h4>\n
As Mark Baker<\/a> explains so well, in the topic-based method, \u201cevery page is page one.\u201d Since every topic is self-sufficient, we don\u2019t know in which order users will be consulting our topics. This is why we always have to put users into context<\/b>. Sometimes, this means repeating elements from one topic to another. The key is saying enough to situate the users and to provide a complete and independent topic without, however, wandering from its purpose.<\/p>\n The title should precisely describe the subject being presented. Don\u2019t forget: the title is the users\u2019 main tool for finding the topics that are relevant to their questions. Coming up with the right title can be quite the challenge! It should be specific, but simple. It should summarize the topic<\/b>, but also make it easy to find.<\/p>\n With the topic-based method, users can seek out only the information they need, without having to sift through information that is not useful. Like tourists who visit a chain of islands and decide which ones to visit and in which order, users choose what they want to read and when.<\/p>\n To learn more…Spot-on titles<\/h4>\n
User freedom<\/h4>\n
\nEvery page is page one<\/a><\/p>\n