Robert Desprez Communications

  • My Services
  • My Blog
  • About Me
  • Contact Me
You are here: Home / Help Authoring Tools / MAKING ONLINE HELP SEO FRIENDLY

MAKING ONLINE HELP SEO FRIENDLY

February 26, 2011 by RDesprez 3 Comments

Tweet

When you’re look­ing for help when faced with some tech­nol­o­gy-relat­ed ques­tion, how do you find assistance?

Maybe you ask a per­son if you’re at work. Per­haps you fire up the help with the prod­uct, if it’s avail­able. Maybe you vis­it the company’s web site and troll through the sup­port sec­tion, look­ing for the answer to your ques­tion. But increas­ing­ly, I sus­pect that more and more users are typ­ing the prob­lem they face into Google’s search field because more often than not, it pro­vides the most accu­rate and rel­e­vant results.

As a tech­ni­cal writer, if you’re post­ing con­tent online that can be searched by search engines, it may be worth bor­row­ing Search Engine Opti­miza­tion (SEO) tac­tics to make your con­tent easy to find on the Inter­net. Some back­ground: SEO is the process of improv­ing the vis­i­bil­i­ty of a web site using search results. So, for exam­ple, if you work as a tech­ni­cal writer in Seat­tle and some­one types the key­words “Seat­tle tech­ni­cal writer” into Google, ide­al­ly your web site is one of the first to dis­play in the results.

Now imag­ine that you gen­er­ate Web­Help for your com­pa­ny and it’s host­ed on a web serv­er that can be searched by Google. As some­one who has per­formed SEO and web ana­lyt­ics on a web site, here’s how I’d start to make the help “SEO friend­ly” so that it appears promi­nent­ly in the search results.

(NOTE: This top­ic pro­vides just an overview of “organ­ic” SEO tac­tics. The oth­er main way to improve your search results is by pay­ing for them but I won’t deal with this method in this blog entry.)

  1. Dou­ble-check that the <title> tag of your online help is an accu­rate descrip­tion. I’d include three ele­ments of the title tag: com­pa­ny name, prod­uct name, and the phrase, “Online Help.” For exam­ple, “ACME RasterBlaster Online Help.” Ensur­ing the title tag is clear is one key way to help with SEO rankings.
  2. Add lots of relat­ed hyper­links that point to the help. Make sure that rel­e­vant web sites (for exam­ple, your sup­port web site, forums on the prod­uct, relat­ed blogs) have links point­ing to your help, which improve SEO rank­ings. Aim for qual­i­ty links, not quantity.
  3. Ana­lyze key­words. Key­words are the terms that your users type when search­ing for help on your prod­uct, such as “con­fig­ur­ing RasterBlaster.” When you know these key­words, make sure that you’ve lib­er­al­ly added the same terms to your “Con­fig­ur­ing RasterBlaster” help top­ic. Adding key­words to your con­tent is anoth­er key way to improve SEO results. Google AdWords is one tool that helps with ana­lyz­ing key­words on a web site.
  4. Add meta-data to impor­tant top­ics in the help. In the <meta> tag in the HTML code for an impor­tant help top­ic, make sure you add rel­e­vant syn­onyms that ide­al­ly match the key­words a user might type in a search engine.
  5. After you’ve per­formed some of the pre­vi­ous sug­ges­tions, be patient. Results don’t hap­pen overnight. After 10 days, type the iden­ti­fied key­words (for exam­ple, ACME RasterBlaster Online Help) into Google. Where are you locat­ed in the results? If you’re not ranked very well, per­haps you need to tweak your key­words, meta-data, or point more rel­e­vant links to the help sys­tem. In anoth­er sev­en to 10 days, see if your results have improved, based on your edits.

The SEO tac­tics that I’ve described are free and do work but they do not offer fast results. With some per­sis­tence, these ideas may just help your users find the answers they need.

Filed Under: Help Authoring Tools, Robert Desprez | Vancouver technical writer | Blog, Search Engine Optimization Tagged With: online help, Search Engine Optimization, SEO

Comments

  1. Terry says

    March 21, 2012 at 6:39 pm

    Robert,

    Great post! I see you that you have been suc­cess­ful in rais­ing your site’s pro­file — you appear on the first page of Google results when I search for “Van­cou­ver tech­ni­cal writer”.

    Reply
  2. Robert says

    March 21, 2012 at 6:40 pm

    Thanks Ter­ry!

    Reply

Trackbacks

  1. Optimizing your online help for Google | says:
    March 29, 2012 at 5:24 pm

    […] * Opti­miz­ing meta-tags. To help webcrawlers index the con­tent in your help, spend some time adding HTML tags to each top­ic. You need to dou­ble-check the title tags, review your key­words, and add rel­e­vant hyper­links to your help. See my ear­lier blog post Mak­ing Online Help SEO Friendly. […]

    Reply

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

About Robert Desprez

I have worked as a Vancouver technical writer for more than 20 years, working at some of British Columbia's largest high-tech firms. I have served in leadership positions for the Society for Technical Communication and have worked as a writing instructor at Vancouver's Simon Fraser University.

Robert Desprez Follow 1,147 239

Vancouver Technical Writer. Former Instructor at Simon Fraser University. Dog Lover. Coffee Drinker. Tennis and Piano Player.

robert_desprez
robert_desprez avatar; Robert Desprez @robert_desprez ·
16 May 1923413647243559161

Image for twitter card

I Regret My Tesla | The Walrus

I wanted to be good. Then the car company fell from grace

thewalrus.ca

Reply on Twitter 1923413647243559161 Retweet on Twitter 1923413647243559161 0 Like on Twitter 1923413647243559161 0 Twitter 1923413647243559161
robert_desprez avatar; Robert Desprez @robert_desprez ·
16 May 1923413050498957392

Image for twitter card

Brian Chesky Lost His Mind One Night—and Now He's Relaunching Airbnb as an Everything App

Airbnb's CEO is spending hundreds of millions to relaunch his travel company as an all-purpose service app. Fitness!...

www.wired.com

Reply on Twitter 1923413050498957392 Retweet on Twitter 1923413050498957392 0 Like on Twitter 1923413050498957392 0 Twitter 1923413050498957392
robert_desprez avatar; Robert Desprez @robert_desprez ·
16 May 1923412665478627824

Toronto Centre MP Evan Solomon appointed Canada’s first AI minister /via @globeandmail

Image for twitter card

Toronto Centre MP Evan Solomon appointed Canada’s first AI minister

Experts say Solomon could face a host of challenges in his role, including how to increase AI adoption and comme...

www.theglobeandmail.com

Reply on Twitter 1923412665478627824 Retweet on Twitter 1923412665478627824 0 Like on Twitter 1923412665478627824 0 Twitter 1923412665478627824
robert_desprez avatar; Robert Desprez @robert_desprez ·
2 May 1918126029463536113

This productivity poison is exhausting you /via @globeandmail

Image for twitter card

This productivity poison is exhausting you

Constantly shifting your attention undermines what is your super power in most knowledge jobs. How you anticipate an...

www.theglobeandmail.com

Reply on Twitter 1918126029463536113 Retweet on Twitter 1918126029463536113 0 Like on Twitter 1918126029463536113 0 Twitter 1918126029463536113
Load More

Recent Blog Posts

  • ChatGPT: The AI-Powered Proofreader
  • Four Ways Confluence Could Be Better
  • First impressions of MadCap’s purchase of IXIASOFT
  • Online Conferences for Technical Writers in 2023

About Me

Robert Desprez I have worked as a Vancouver technical writer for more than 20 years, working at Kodak, Boeing, Teck Resources, and FortisBC. In addition, I have worked as a writing instructor at Simon Fraser University in Vancouver.

Contact Me

Robert Desprez Com­mu­ni­ca­tions Inc.
North Van­cou­ver, British Columbia
Canada
Phone: 604–836-4290

  • Email
  • LinkedIn
  • Twitter

Copyright © 2025  · Robert Desprez Communications Inc.