Re: Organizing a Knowledge Base

Subject: Re: Organizing a Knowledge Base
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: "TECHWR-L (techwr-l -at- lists -dot- techwr-l -dot- com)" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 1 Nov 2013 16:04:27 -0700

support.tivo.com is a pretty complex app or set of apps. It goes way
beyond any KB I've worked with.

On Fri, Nov 1, 2013 at 3:36 PM, Laura Lemay <lemay -at- lauralemay -dot- com> wrote:
>
> I was thinking about the two knowledge bases I've encountered the most:
> TiVo: http://support.tivo.com/app/home
> Audible: http://audible.custhelp.com/
>
> Both have broad categories for information, with the articles in those categories organized by popularity. (and prominent search, of course)
>
> So yes I would argue that categories have value in KB, but as simple buckets, not as a top-to-bottom organizing principle.
>
> Laura
>
>
> On Nov 1, 2013, at 12:22 PM, Robert Lauriston wrote:
>
>> There's no industry standard because most KBs don't have that feature.
>>
>> If you have multiple applications, it might make sense to have one
>> folder per application. Anything more granular than that might just
>> make it harder for users to find what they want. Assuming folders are
>> even exposed to users rather than just being there to help manage
>> access privileges.
>>
>> On Fri, Nov 1, 2013 at 12:16 PM, Cardimon, Craig <ccardimon -at- m-s-g -dot- com> wrote:
>>> You are correct thus far.
>>>
>>> FreshDesk offers the option to create your own folders, which the higher-ups have done.
>>>
>>> I wanted to know if there was a common-sense industry standard for organizing KBs, should I want to justify any changes I make to the folder structure.
>>>
>>> -----Original Message-----
>>> From: robert -dot- lauriston -at- gmail -dot- com [mailto:robert -dot- lauriston -at- gmail -dot- com] On Behalf Of Robert Lauriston
>>> Sent: Friday, November 01, 2013 2:39 PM
>>> To: Cardimon, Craig
>>> Cc: TECHWR-L (techwr-l -at- lists -dot- techwr-l -dot- com)
>>> Subject: Re: Organizing a Knowledge Base
>>>
>>> With only five people on the help desk, you should have no problem keeping up with everything they log. That should make it clear what customers are asking about so that you know which existing KB articles need work and what new ones to add.
>>>
>>> When you're wearing your editor's hat, in my experience common problems with articles drafted by non-writers are too much jargon, bad examples, wrong or incomplete use cases, missing information, and lumping two or more distinct issues into one article.
>>>
>>> What does "organize it" mean? KBs are normally search-driven. Does FreshDesk offer some other options?
>>>
>>>
>>> On Fri, Nov 1, 2013 at 9:58 AM, Cardimon, Craig <ccardimon -at- m-s-g -dot- com> wrote:
>>>> About five people or so. They want me to create new items, edit the stuff that's already there, and think about how best to organize it.
>>>>
>>>> -----Original Message-----
>>>> From: robert -dot- lauriston -at- gmail -dot- com [mailto:robert -dot- lauriston -at- gmail -dot- com]
>>>> On Behalf Of Robert Lauriston
>>>> Sent: Friday, November 01, 2013 12:55 PM
>>>> To: Cardimon, Craig; TECHWR-L (techwr-l -at- lists -dot- techwr-l -dot- com)
>>>> Subject: Re: Organizing a Knowledge Base
>>>>
>>>> You have a help desk crew using that same tool? If so, how many people?
>>>>
>>>> On Fri, Nov 1, 2013 at 9:43 AM, Cardimon, Craig <ccardimon -at- m-s-g -dot- com> wrote:
>>>>> It's called "FreshDesk."
>>>>>
>>>>> -----Original Message-----
>>>>> From: robert -dot- lauriston -at- gmail -dot- com [mailto:robert -dot- lauriston -at- gmail -dot- com]
>>>>> On Behalf Of Robert Lauriston
>>>>> Sent: Friday, November 01, 2013 12:41 PM
>>>>> To: Cardimon, Craig; TECHWR-L (techwr-l -at- lists -dot- techwr-l -dot- com)
>>>>> Subject: Re: Organizing a Knowledge Base
>>>>>
>>>>> What software are you using?
>>>>>
>>>>> On Fri, Nov 1, 2013 at 8:54 AM, Cardimon, Craig <ccardimon -at- m-s-g -dot- com> wrote:
>>>>>> The KB software is already in place. I'm the cleanup crew.
>>>>>>
>>>>>> -----Original Message-----
>>>>>> From: robert -dot- lauriston -at- gmail -dot- com [mailto:robert -dot- lauriston -at- gmail -dot- com]
>>>>>> On Behalf Of Robert Lauriston
>>>>>> Sent: Friday, November 01, 2013 11:54 AM
>>>>>> To: Cardimon, Craig; TECHWR-L (techwr-l -at- lists -dot- techwr-l -dot- com)
>>>>>> Subject: Re: Organizing a Knowledge Base
>>>>>>
>>>>>> Do you need to choose the KB software or is that already in place?
>>>>>>
>>>>>> A typical structure is:
>>>>>>
>>>>>> - problem statement
>>>>>> - solution(s)
>>>>>> - links to related articles and other resources
>>>>>>
>>>>>> A knowledge base is by definition unorganized.
>>>>>>
>>>>>> A KB is similar to a blog in that each article stands alone. It's similar to a wiki (especially a flat wiki without a navigation tree, such as MediaWiki) and SEO in that tagging / keywords can be important in helping users find the right information.
>>>>>>
>>>>>> On Fri, Nov 1, 2013 at 4:50 AM, Cardimon, Craig <ccardimon -at- m-s-g -dot- com> wrote:
>>>>>>> I have been asked to help with organizing/writing topics in a knowledge base.
>>>>>>>
>>>>>>> I'm enthusiastic, but I haven't done this kind of thing before.
>>>>>>>
>>>>>>> Where can I go to study up how to put together a KB?
>>>>>> Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email, do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please immediately notify the sender by telephone or email reply.
>>>>> Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email, do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please immediately notify the sender by telephone or email reply.
>>>> Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email, do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please immediately notify the sender by telephone or email reply.
>>> Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email, do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please immediately notify the sender by telephone or email reply.
>>
>>
>> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>> New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.
>>
>> Learn more: http://bit.ly/ZeOZeQ
>>
>> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>>
>> You are currently subscribed to TECHWR-L as lemay -at- lauralemay -dot- com -dot-
>>
>> To unsubscribe send a blank email to
>> techwr-l-leave -at- lists -dot- techwr-l -dot- com
>>
>>
>> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
>> http://www.techwhirl.com/email-discussion-groups/ for more resources and info.
>>
>> Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com
>>
>> Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives
>


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
Organizing a Knowledge Base: From: Cardimon, Craig
Re: Organizing a Knowledge Base: From: Robert Lauriston
RE: Organizing a Knowledge Base: From: Cardimon, Craig
Re: Organizing a Knowledge Base: From: Robert Lauriston
RE: Organizing a Knowledge Base: From: Cardimon, Craig
Re: Organizing a Knowledge Base: From: Robert Lauriston
RE: Organizing a Knowledge Base: From: Cardimon, Craig
Re: Organizing a Knowledge Base: From: Robert Lauriston
RE: Organizing a Knowledge Base: From: Cardimon, Craig
Re: Organizing a Knowledge Base: From: Robert Lauriston
Re: Organizing a Knowledge Base: From: Laura Lemay

Previous by Author: Re: Organizing a Knowledge Base
Next by Author: Re: Best places to put topics when they're needed twice
Previous by Thread: Re: Organizing a Knowledge Base
Next by Thread: Re: Organizing a Knowledge Base


What this post helpful? Share it with friends and colleagues:


Sponsored Ads