Re: Content management

Subject: Re: Content management
From: Mark Giffin <mgiffin -at- earthlink -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Tue, 28 Jan 2020 18:28:13 -0800

Helen,

Thanks for the detailed description of your use of Confluence and drawbacks, it's useful.

On the search, what does Confluence use by default for search? Is it something ordinary like Solr or Elasticsearch? Maybe it can be pulled out to run on a separate server to reduce performance hits. And once facets are set up for the search index for docs, in my experience there is not much ongoing maintenance. So maybe it can be a one-time deal. Or maybe you could use a search app like Algolia to index your docs separate from the rest of your company's website.

As for your company's requirement that "the content creation experience is expected to be uniform for everyone", that seems pretty arbitrary. It sounds like they do not know what tech writers do. It sounds like a sensible policy for casual users, so they don't have to learn multiple ways to edit, but tech writers are usually beyond that category.

Mark Giffin
Mark Giffin Consulting, Inc.
http://markgiffin.com/

On 1/28/2020 4:54 PM, Helen OBoyle wrote:

Hi Robert,

I haven't been too impressed with Scroll's plug-ins, but folks with simpler
requirements seem to find them sufficient. For example, one didn't coexist
well with automated uploads via the Confluence REST API, and therefore we
couldn't use it.

For some sites that have distinct "content producer" and "content consumer"
populations, it's likely a good recommendation to do as you say, with one
instance set up for content creation and the other set up for consuming
content to minimise license costs. At our org, every user is also expected
to be a potential content creator, though, and the content creation
experience is expected to be uniform for everyone, from a field tech who
wants to tweak an installation document whilst on site, to a marketing
specialist or product manager who wants to adjust the order of items in a
list of product features, to the tech writers who create product
documentation.

In terms of managing separate instances, how do you promote content from
one instance to the other, keep it in sync, etc.? I'd be interested in
hearing from people who are doing this in the real world about the tools
you're using and any gotchas you've found. Is anyone doing this
bi-directionally? (As in, content can be updated at any site, and pushed to
1 or more other sites, rather than just a simple "work" instance and a
master publication instance.)

Kind regards,

Helen.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | https://techwhirl.com

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

You are currently subscribed to TECHWR-L as mgiffin -at- earthlink -dot- net -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

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | https://techwhirl.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-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


Follow-Ups:

References:
Re: Content management: From: Jeff Scattini
Re: Content management: From: Shari Punyon
Re: Content management: From: Helen OBoyle

Previous by Author: Re: I need a better File Previewer
Next by Author: Collaborative PDF markup tools
Previous by Thread: Re: Content management
Next by Thread: Re: Content management


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


Sponsored Ads