RE: Best Practice...Reuse Content

Subject: RE: Best Practice...Reuse Content
From: "Dan Goldstein" <DGoldstein -at- riverainmedical -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 2 Feb 2011 17:27:46 -0500

Tricky question, because whom would the ladder-dweller consider to be an expert?

There's Sarah O'Keefe at http://www.scriptorium.com, who does a great job on presenting best practices for shared content. For example, see her 2005 presentation at http://www.scriptorium.com/LavaConBizCaseXML.pdf.

JoAnn Hackos has published extensively online and in print about single-sourcing.

How about O'Reilly? Try http://www.toccon.com/toc2008/public/schedule/detail/3179, or really anything on http://www.xml.com, which O'Reilly owns.

There's lots of stuff on single-sourcing at www.stc.org - surely the most visible Web site for our profession. (But beware of the STC's single-sourcing SIG, which is apparently moribund.)

And again, the real question is, what names would *she* recognize?

Heck, if anyone at my company mentioned "John Posada" as their source for something, I would recognize that as an expert's name.


-----Original Message-----
From: John Posada
Sent: Tuesday, February 01, 2011 5:00 PM
To: List, Techwriter
Subject: Best Practice...Reuse Content

Humor me for a minute

I'm now a Knowledgebase analyst with an opportunity to present a case to rearchitect my company's external knowledgebase that is used for customer self-help support.

Understand that to do what I'm asking, there will be changes at the code level, so I need to build a pretty strong case.

We currently have three regional knowledgebases; US customers, Canadian customers, and UK customers.

Based on an analysis that I recently performed, 29% of the content is almost identically replicated in all three regions. Let me say that again. 29% of the content appears pretty much the same in three regions. So, if it takes 50 words to describe something, we have 150 words doing it; 50 in each region.

I've made a recommendation that we have one piece of content, written once and shared by the three regions. Pretty simple, huh?

You and I know the benefits to this...that is not my question and I have some interest in this concept from some levels in this company. However, the person I have to convince is pretty high up on the ladder and her hot buttons are "best practices prescribed by experts"

Therefore, I'm interested in material that backs me up on the premise that there shouldn't be the same content written more than once, preferably from people with name recognition.





This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.

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

Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com

---
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-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

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

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
Best Practice...Reuse Content: From: John Posada

Previous by Author: RE: Hidden batch limits in Acrobat
Next by Author: RE: Customer-friendly word for "landline"
Previous by Thread: RE: Best Practice...Reuse Content
Next by Thread: Re: Best Practice...Reuse Content


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


Sponsored Ads