
Profitable self-service requires eradicating any friction that may get in your buyer’s manner. We work onerous to make our information bases straightforward to look and extremely accessible so folks can land proper on the article that solutions their query.
At that time, our job is to assist them learn, perceive, and apply the reply. That’s the place format and web page composition could make a essential distinction. Having the precise phrases isn’t all the time sufficient; they have to be comprehended. Design actually does matter.
Do you know, for instance, that if it wasn’t for some creative doc design work by Irish scribes within the seventh century, wewouldntevenhavespacesbetweenwords?
Redesigning a information base article
To finest illustrate good data layouts, let’s begin with a typical “information lump” doc. All the data on the web page is correct and helpful, however the format is de facto letting it down.
It’s onerous to scan and unappealing to have a look at, and it’s possible that even individuals who would profit from the data it accommodates would surrender earlier than studying all of it.
By taking this doc step-by-step by way of the rules of visible communication, we will make easy, iterative enhancements till we find yourself with a assist web page that’s vastly extra readable.
Distinction
Distinction simply means “distinction,” and it’s a primary precept of design. For our pattern doc, that begins with giving the textual content a colour that stands out from the background. We’ll use a plain background, avoiding textures or photos that battle with the textual content.
Already, it’s a lot simpler to learn, particularly for almost all of people that don’t have excellent eyesight. We’ll use distinction once more as we take into account headings and callouts in a while.
White area
White area refers to empty area round and between web page parts (like textual content, web page margins, and pictures), whether or not it’s truly white or not.
A 2004 examine by D.-Y.M. Lin discovered that the usage of white area between paragraphs and within the left and proper margins elevated comprehension by nearly 20 % for older readers.
So let’s add some margins round our doc, improve the road spacing, and separate our paragraphs slightly.
Make your textual content bigger
The all-time file holder for commonest grievance about web sites is “the textual content is simply too small!” In fact your great younger eyes in all probability don’t have any bother in any respect studying microscopic textual content, however the remainder of us admire one thing slightly bigger.
minimal font measurement to shoot for is 16px, though it’s the mix of font face, measurement, and line peak that make up the general readability stage.
Use headings for easier scanning
Break up lengthy blocks of textual content with headings in order that readers can extra simply discover simply the part they’re after. A heading with enough distinction and white area is a pleasant touchdown place for the reader’s eyes, and it could possibly assist them determine whether or not to speculate extra time on the web page.
In our pattern doc, including a couple of headings makes the general content material of the web page way more apparent at a look.
Use bullets, lists, and anchors
Establish components of your doc that may be transformed from prose into bullet factors or numbered lists. When you have a set of steps that prospects have to comply with or a couple of essential items of data to impart, these are nice candidates for a listing.
In case your web page is pretty lengthy, take into account including a desk of contents on the high. A well-written desk of contents helps readers shortly perceive what the doc covers and permits them to leap on to the data they want.
Extract key quotes
For quotes or necessary nuggets of data that stand alone (and aren’t a part of a listing), pulling them out of the textual content move right into a pull quote will make them straightforward to identify. In our instance, we’ve emphasised the important thing step within the course of to modify on their auto-reply settings.
Use screenshots and GIFs
Wherever doable, utilizing a screenshot to point out what you imply quite than laboriously describing it in textual content makes assist paperwork simpler. In our instance, we will tremendously simplify our clarification by referring to the screenshot.
assist doc screenshot ought to:
Be massive sufficient to be simply readable. You could have to crop a screenshot to maintain the important thing data at an inexpensive measurement whereas becoming into your web page.
Comprise visible context so readers perceive what they’re . Don’t crop too tightly!
Be annotated the place applicable (take into account labeling objects in the event you seek advice from them in your copy).
The identical guidelines typically apply for animated GIFs and movies, too.
Implementing format enhancements
Relying on the information base or CMS system you’re utilizing, most of the visible styling enhancements could be made by way of CSS modifications that may apply throughout all your paperwork.
For structural enhancements like lists and headings or for screenshots and movies, you may have slightly extra document-by-document work forward of you.
Assist Scout’s Docs editor contains fast entry to formatting fundamentals, like daring and italic, however it additionally permits for fast lists, tables, blockquotes, and callouts. Slightly work in your half will assist numerous future readers to shortly learn and comprehend.
Judging a e-book by its cowl
They all the time say to not choose a e-book by its cowl, however a e-book’s cowl typically offers a shopping reader essential hints concerning the style, type, and subject of the e-book. The design helps you contextualize the content material. In the identical manner, the design of your information base articles can actually enhance the power of your prospects to understand the content material.
Keep in mind that a great doc is all the time in service to the reader; you’re not attempting to amaze them together with your stunning doc, you’re attempting to assist them discover and perceive precisely what they want as shortly as doable.
It’s value investing some effort and time to make sure your prospects are studying and receiving data in the very best format. A well-designed information base can elevate your buyer expertise whereas additionally lowering the dimensions of your assist queue — a win-win for everybody concerned.

