Division of content in help based environments per information type

There are a lot of how-to guides that help companies set up a knowledge base for both internal and external use. Before you choose an information and/ knowledge management however, it’s good to see what information needs to be put in what container. Here are 4 containers that are especially valid in help-(desk) environments.

Terminological based  information management

In short: what does this word mean?

Like: what is an API?

Terminological information in companies is often referred to as ‘the glossary’. The list of words or abbreviations that are required of customers, users or employees to perform certain tasks.

This often seems the low hanging fruit. After all, everyone in and outside of the organisation knows what a flowering plant is right? It’s either a blossoming weed or a garden plant, as yourdictionary explains in this article about semantics. Imagine writing in your various help documents: “Please make sure no flowering plants are near the designated area of maintenance”. Would that mean that I need to first remove all the weeds, or, make sure there are no garden plants in the area. In the case of say, using an insecticide. You think that’s a cute example? Imagine something like this being in the help texts of multibillion agriculture chemical producer like BASF. Note: I’m very sure that this is example doesn’t apply to them

Another example: the company doesn’t even know what they mean exactly. A few years back I worked at a company where the terms Daughter-company and Parent-company needed be explained. The problem? Nobody knew what it was exactly. In a more general manner these terms were an indication about the relationship to another, related company: either you were the smaller, supported party or, you were the bigger overarching company. Not that hard right? Except the definition determined if you had to pay a yearly fee or not. With legal implications if you didn’t.

Hence, terminology is important. Keep in mind the infamous 20/80% rule: 20% of the terminology will create 80% of the work, as those are the terms that people will have strikingly different ideas about.

Functionality based  information management

In short: what does this button do?

Like: what happens if I press this button?

Information Management Download Button Functionality Type of Information



And: how is it different from this one?

Information Management Download Button Functionality Type of Information


If you hadn’t guessed it already, the first is a download button. The second is a ‘go’-button after having entered a search term. It could also have been a ‘go’-button after having entered contact details which someone would like to have processed. In a “contact-me-for-a-product-demo”. So yes, also important.

I’ve heard (mainly non IT, UI/UX, sorry) people say: “the new system will be self-explanatory”. Please don’t. Yes, a very good case can be made for good interface design, how it supports efficiency and understanding, but nothing will ever be fully self-explanatory. Which is OK. Just provide good support.

Especially with functionality questions, context is important. What was someone’s previous action, what part of the system of site are they active in and what are they trying to achieve as a next step? For the user, these shouldn’t be questions. They be made clear through consistent and clear terminology (point in case above), clear navigational hints and an overview of the process someone is in (see below).

Does a functionality really need explaining? Then be inclusive. Say someone doesn’t understand the download button, make sure you know what they don’t know about it. Picture a hover-over that says “This is a download button”, well, that might have been obvious. Make clear that the user knows what she’s downloading. A file? What file? E.g. “Download the employee survey 2016” is much better. That’s why download links are so popular these: they allow you to include text.

Process based  information management

In short: where is the user in the overall process?

Like: what happens next?

Best example ever that we all know: “Thank you for contacting us”. Now what do I do? Another one: “We are processing you request”. Great, how long’s that going to take?

A good exercise is to bullet point the process for (the type of) user and make sure that it’s clear what the connecting steps are per phase. The end step of the last phase or action (depending on the size of the process) is important to the next phase. How often do you book a flight with someone and you go “Is that for both of us? The price seems a bit low”.  Not at Transavia. They make it extremely clear what you’ve selected and what the current total amount of money is for what amount of travelers.

Transavia Contextual Navigation

If you do need help in the form of larger display of text, preferably do it at the beginning or end of a process. For example:

“Thank you for registering! We’re going to ask you about your exact annual revenue of the previous year and the exact amount of employees, because those determine your fee. Don’t have that information at hand? Click the Reminder Button below to receive an e-mail tomorrow at 10 o’clock to remind you to continue your registration process”.

Or at the end of the process:

“Thank you for your contact details. We will let you know within 5 working days whether or not your application has been accepted. If your application has been accepted, you can immediately continue your enrollment. If you application has been denied we’ll provide feedback on the reasons.”

Task based information management

In short: How do I add a user?

Then there’s another type of information request: tasks. Those often need a little more explanation and are harder to leave out, solve with 1-3 words or solve with an icon or navigational element.

Sometimes users have a vague idea of where to look. For ‘payment options’ they probably need to check the tab ‘Financial Information’, and to add a user ‘User Management’ or ‘Team’ seem to make sense. However, I have seen examples where an overview of the payment procedure was not provided in the “Finance” tab, but in the general “Profile” area under “Bank Account Number – ABCD0001212121”, where they had to click the number to find out about the procedures, payment options etc.

Tasks might need more space to be explained, but they are easier to define and prioritize. A good analysis of the questions answered (by your help desk?) on a daily basis give you a very good overview of the top 10-20 questions asked for which a short how-to guide or FAQ can be composed. A canned e-mail response might also do the trick.


Whatever your format of choice is to deal with questions, make sure a clear distinction is made in the type of information, who and where it should be resolved. Create an overview, control over your help information and consistent and clear answers for your users by analysing and categorizing the questions you get and the answers you give. Not everything is task, not answers can be given via Twitter and not all process overviews consume the user’s time.

19 thoughts on “Division of content in help based environments per information type

  • An attention-grabbing discussion is price comment. I think that you must write extra on this topic, it won’t be a taboo subject but typically persons are not enough to speak on such topics. To the next. Cheers

  • I and also my pals appeared to be viewing the good key points found on your web page and quickly came up with a horrible feeling I never thanked the web blog owner for those strategies. All the women had been as a result very interested to see them and have in effect in actuality been making the most of those things. Appreciation for indeed being so kind and then for deciding on such smart useful guides most people are really desperate to be aware of. My very own sincere regret for not expressing gratitude to earlier.

  • I抎 should test with you here. Which is not something I often do! I enjoy studying a submit that can make individuals think. Additionally, thanks for permitting me to remark!

  • Thanks for all your valuable labor on this website. Debby loves conducting research and it is simple to grasp why. A lot of people notice all about the powerful ways you create rewarding strategies by means of this web blog and increase participation from other ones on the article plus my daughter is now understanding so much. Take pleasure in the remaining portion of the year. You’re the one doing a brilliant job.

  • 439283 999769Someone necessarily assist to make critically articles Id state. This really is the initial time I frequented your internet page and thus far? I amazed with the analysis you created to make this actual submit incredible. Exceptional activity! 712754

  • There are actually a whole lot of particulars like that to take into consideration. That could be a nice level to carry up. I provide the thoughts above as general inspiration but clearly there are questions just like the one you deliver up the place a very powerful thing might be working in trustworthy good faith. I don?t know if best practices have emerged around issues like that, but I am certain that your job is clearly identified as a good game. Both boys and girls feel the impression of just a second抯 pleasure, for the remainder of their lives.

  • My husband and i got absolutely satisfied that Ervin managed to deal with his reports out of the precious recommendations he made out of the blog. It’s not at all simplistic to simply happen to be making a gift of key points which often the others might have been making money from. We fully understand we now have the writer to give thanks to for this. Most of the illustrations you made, the simple website navigation, the friendships you can make it easier to create – it’s everything impressive, and it’s facilitating our son in addition to us know that the subject matter is excellent, which is really important. Many thanks for all!

  • My husband and i felt now satisfied Chris could carry out his homework with the precious recommendations he was given in your blog. It’s not at all simplistic to just choose to be making a gift of instructions which often the rest might have been making money from. And we all fully grasp we now have the website owner to thank because of that. Those illustrations you have made, the simple website menu, the relationships you will help engender – it’s all overwhelming, and it’s really letting our son in addition to us feel that the concept is enjoyable, which is exceedingly important. Thank you for the whole thing!

  • 294132 247882Thanks for helping out, superb information . 755070

  • You made some respectable factors there. I seemed on the internet for the issue and found most individuals will go together with with your website.

  • 207898 717672Previously you need to have highly effective web business strategies get you started of obtaining into topics suitable for their web-based organization. educational 39383

  • 598622 817179An fascinating discussion may be valued at comment. I do believe which you merely write read far more about this subject, it may possibly not often be a taboo topic but normally persons are too couple of to dicuss on such topics. To a higher. Cheers 518681

  • I wanted to send you that bit of word just to say thanks a lot once again for your lovely views you have provided on this page. It was really surprisingly generous with you to offer publicly all most of us might have advertised as an e book to get some profit for their own end, most notably considering the fact that you might well have done it if you ever desired. Those tactics additionally served as the easy way to recognize that many people have the same fervor like my very own to figure out a lot more with regard to this matter. I am certain there are thousands of more pleasant moments in the future for those who read carefully your blog.

  • I definitely wanted to type a quick message in order to express gratitude to you for some of the stunning hints you are posting at this site. My time intensive internet lookup has now been recognized with reasonable content to exchange with my friends and classmates. I would state that that most of us visitors are extremely blessed to exist in a really good website with so many awesome individuals with beneficial suggestions. I feel somewhat privileged to have encountered the webpage and look forward to many more exciting minutes reading here. Thanks again for a lot of things.

  • I just want to tell you that I am all new to blogging and site-building and honestly savored this web-site. More than likely I’m likely to bookmark your blog post . You definitely have tremendous stories. Thanks for revealing your web-site.

  • I just want to tell you that I am just beginner to blogging and site-building and seriously loved this web site. More than likely I’m planning to bookmark your blog post . You amazingly come with amazing well written articles. Regards for sharing with us your webpage.

  • 881894 425285I love the appear of your web site. I lately built mine and I was searching for some style tips and you gave me a couple of. Could I ask you whether you developed the web site by youself? 623565

  • I used to be very happy to seek out this net-site.I needed to thanks for your time for this wonderful learn!! I definitely enjoying every little bit of it and I have you bookmarked to take a look at new stuff you weblog post.

  • I have to convey my affection for your kind-heartedness supporting people who have the need for help on the subject. Your very own commitment to getting the solution all around had been extremely important and have truly made men and women just like me to achieve their dreams. Your new informative report means so much a person like me and additionally to my mates. Thank you; from all of us.

Geef een reactie

Het e-mailadres wordt niet gepubliceerd. Verplichte velden zijn gemarkeerd met *