Re: any useful doc tools in Zendesk?

Subject: Re: any useful doc tools in Zendesk?
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: TECHWR-L Writing <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 27 Oct 2016 11:56:37 -0700

The good news is Paligo can now publish to Zendesk articles.

The bad news is it really works only for single topics.

If you have a complicated document with several levels of topics, all
the subtopics are folded into the top-level parent topic. For example,
I have several hundred topics in a single document that we distribute
as a ~350-page PDF and online help. The top-level topics are basically
book titles: Programmer's Guide, Administrator's Guide, etc. On export
to Zendesk, all the topics in the Programmer's Guide got dumped into a
single file.

To make matters worse, all cross-references are converted to static
text. Paligo adds "the section called" before the topic name, but
there's no way to tell which top-level file contains that topic. My
docs are extensively cross-referenced (that's one of the reasons
they're distributed as a single PDF or help system), so the Zendesk
version is pretty much impossible to navigate.

This is apparently a limitation of Zendesk, so there's probably
nothing Paligo can do about it.

Even with these limitations, it should be very useful for some users.

On Wed, Jul 22, 2015 at 11:08 AM, Robert Lauriston <robert -at- lauriston -dot- com> wrote:
> We're looking at Zendesk.
>
> Is there anything in there that I should evaluate for possible use by docs?
>
> Do any authoring tools integrate with it in useful ways?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://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


Previous by Author: Re: Acrobat Shared Reviews
Next by Author: Re: Web page content commenting/review tool recommendations?
Previous by Thread: Google Docs > Zendesk Knowledge Base
Next by Thread: Web page content commenting/review tool recommendations?


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

Sponsored Ads


Sponsored Ads