TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Re: Hiding things (was RE: Optimizing OnlineHelp for Mobile Viewing)
Subject:Re: Hiding things (was RE: Optimizing OnlineHelp for Mobile Viewing) From:"Weissman, Jessica" <WeissmanJ -at- abacustech -dot- com> To:Ruth Sessions <ruthsessions03051 -at- yahoo -dot- com> Date:Wed, 3 Aug 2011 16:26:48 -0400
This requirement can be met by any HAT that can output to a screen-viewable PDF with a live Toc that lists all topics. I created such a PDF as one of the output formats for an API doc in my last job. We used Help & Manual.
- Jessica
On Aug 3, 2011, at 4:22 PM, "Ruth Sessions" <ruthsessions03051 -at- yahoo -dot- com> wrote:
> Robert:
>
> Actually, I've received complaints from some technical customers (for SDKs)
> about being forced to click with the mouse too often in Help files.
>
> One such techie suggested we use a continuous scrolling approach. I'm not sure
> if everyone would like it this solution for reference Help, but it fulfills his request:
> Put all APIs in a single topic and link from the contents to a subheading for each API.
> The customer can then click OR scroll to select a particular API.
>
> Or some HATs might have features to arrange the APIs that way even after you put
> each in its own topic. Ideally, the option should be available.
>
> Do you think such a result could be achieved using RoboHelp, AuthorIT, or another
> HAT you have experience with?
>
> Ruth
>
> ------------------------------------------------------------
> Ruth Sessions
> 603/886-7355
>
>
> ________________________________
> From: Ed Marsh <lists -at- edmarsh -dot- com>
> To: techwr-l -at- lists -dot- techwr-l -dot- com
> Sent: Wednesday, August 3, 2011 9:20 AM
> Subject: Re: Hiding things (was RE: Optimizing OnlineHelp for Mobile Viewing)
>
>
>
> Are you talking about a drop-down *menu*, or a drop-down *list*?
>
>
> -=Ed.
>
> On Tue, 2 Aug 2011 08:16:17 -0700, Robert Lauriston wrote:
>
>>
> Drop-downs make sense in a dialog box or data entry where if you
>>
> exposed all the enums for all the fields they wouldn't fit it in the
>>
> form.
>>
>> They make no sense to me for related topics or "see also" in
> online
>> help. Why make me click on something instead of just letting me
> skim?
>> As a user, when I come across that sort of thing, I'm annoyed.
>>
> Flare's help is full of that stuff, providing a useful negative
>>
> example of their pointless features.
>>
>> If I didn't read fast and
> navigate mostly from the keyboard I might
>> not be so annoyed by a help
> system constantly making me reach for the
>> mouse.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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 ruthsessions03051 -at- yahoo -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/ruthsessions03051%40yahoo.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
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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 WeissmanJ -at- abacustech -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/weissmanj%40abacustech.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
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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-