Re: Best places to put topics when they're needed twice

Subject: Re: Best places to put topics when they're needed twice
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: Editor in Chief <editorialstandards -at- gmail -dot- com>
Date: Sun, 3 Nov 2013 09:59:39 -0800

Have you talked with MadCap support about that? Sounds like a bug to
me. The breadcrumbs properties should be picked up from the TOC.

As a workaround, what if you define two TOCs and merge the projects?

http://webhelp.madcapsoftware.com/flare8/Content/TOCs/Merging_Projects.htm

On Sun, Nov 3, 2013 at 9:42 AM, Editor in Chief
<editorialstandards -at- gmail -dot- com> wrote:
> Not so fast. We feature Breadcrumbs navigation aid prominently at the top
> of every Webhelp topic. If a single topic has more than one link in the
> ToC, it breaks Breadcrumbs (at least, as they are implemented in WebHelp,
> by Flare.
>
> What do other people normally do?
>
> In case the above was obscure, here's an example:
>
> Every computer clock drifts. Many applications need reliable time, both
> within and among connecting systems. We provide three options to achieve
> that:
>
> a) use simple Network Time Protocol (NTP) to receive a signal from a
> standard internet time source, and keep your system's clock adjusted that
> way.
>
> b) do the same as "a)", but with secure NTP, which uses certificate-based
> authentication to ensure no nefarious substitutions of time-correcting
> signals
>
> c) if you aren't allowed to use NTP, then correct your own time with
> built-in drift-correction tools - it works, but is a bit more hands-on.
>
> We estimate that most customers would (or should) use method "b)", so
> that's the one that appears in the Config Guide. But, for completeness,
> that method should appear in the Admin Guide, alongside the other two
> methods. . . especially when a customer might keep only the Admin Guide
> (PDF or printout) handy.
>
> So, duplicate the topic, and risk the copies getting out of sync?
> Or use just one topic for a description/instruction, point to it from two
> or more places, and live with the fact that it breaks the Breadcrumbs
> feature?
> OR.... some third way.
>
> --
> __o
> _`\<,_
> (*)/ (*)
> Don't go away. We'll be right back.
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> 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 robert -at- lauriston -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:
Best places to put topics when they're needed twice: From: Editor in Chief

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: Best places to put topics when they're needed twice
Next by Thread: RE: Best places to put topics when they're needed twice


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

Sponsored Ads


Sponsored Ads