Tuesday, April 7, 2020

MS Word, includetext, and templates

Editor's Note: The link to http://www.paulpehrson.com/flare-content-reuse/ needs to be tested.
Five years ago today, I posted the following on Techwr-L:

On 4/7/2015 1:01 PM, I wrote:
I am so JEALOUS! Over the 20+ years of my career, conversions - whether it
was OfficeVision to Word, WinHelp to HTML, or Word to Confluence - have been
my favorite projects. Even outside of work, I love converting - CDs to MP3,
vinyl to MP3, and cassettes to MP3. Conversions are my passion!

Recently, we've transitioned from authoring in Word and distributing PDFs to
using Confluence. I did not know anything about Confluence until I started
trying to maintain content in it.

One thing I think is worth considering - are your users going to "accept"
your docs on a wiki? We jumped into it, internally reviewed it (within our
dept & and within the company), gave it to the end-users and the first thing
they said? "How do I print a PDF of all the pages?"

<sigh>

We had to add a process for creating a PDF of the user guide that is posted
on our Home page. We make it clear that the PDF is a snapshot of the content
as of MM/DD/YY and that it is going to be quickly out of date if you print
the thing.

All that said, if you suspect you have multiple versions of the same text,
what I messed around with was creating a single (somewhat massive) Word doc
with all the Word doc content in it.

However, before I could do that, I took a copy of each document and replaced
the paragraph character with "- [unique_code]" so that when that document is
combined with all the other Word docs, you know where it came from. For
example, we have a "Adding a User" heading in all of our docs. If you
*don't* add a unique code to each paragraph, you get this:

Adding a User
Adding a User
Adding a User
Adding a User
Adding a User

And you don't know where they came from. For us, states are a good way to
group things so I had:

Adding a User - AZ
Adding a User- CO
Adding a User- FL
Adding a User- TX
Adding a User- VA

So, after you have that pre-processing done, combine the docs into a single
Word doc, because ultimately, what you want is something like this:

Adding a User - AZ
Adding a User- CO
Adding a User- FL
Adding a User- TX
Adding a User- VA
Changing a User - AZ
Changing a User - CO
Changing a User - FL
Changing a User - TX
Changing a User - VA

Then, you create a single version of your procedure, looking at how each
version is different. If there's something customer-specific, then you make
a note of that, but the end result is a single way you are going to tell
your users how to "add a user", how to "change a user", etc.

Then, and only then, do you begin thinking about include fields and such.
Otherwise, you are going to have very similar fields that have only slight
variations that are used for specific customers, but not a single "include"
for all of your docs.

That said, I came across this page the other day -
http://www.paulpehrson.com/flare-content-reuse/ - that may be helpful. It's
older (2007), but some of the philosophy behind it (not the Flare-specific
things] may help you out.



-----Original Message-----
From: Jay Maechtlen
Sent: Tuesday, April 07, 2015 1:19 PM
To: TechWrl list
Subject: MS Word, includetext, and templates

We're using Office 2013 on Windows 7, deployment planned on SharePoint.

1) Anyone using includetext fields to consolidate multiple Word docs? Any comments on best practices, templates, styles, etc?

2) Anyone deploying on SharePoint Wiki sites? We intend to move docs to the Wiki, but building in Word until the Wiki is really ready. (and/or we know how to use it well enough.)

Current docs are combination of Word and Excel docs.

Comments, suggestions welcome.
Thanks
Jay

--
Jay Maechtlen
626 444-5112 office
626 840-8875 cell
www.laserpubs.com

No comments: