Re: Is Search replacing the TOC and Index?

Subject: Re: Is Search replacing the TOC and Index?
From: Paula Cristina Vaz <paula -dot- vaz -at- inesc-id -dot- pt>
To: Andrew Harvie <withanie -at- gmail -dot- com>
Date: Fri, 11 Jul 2014 11:48:40 +0100

Hi there,

I'm a tech writer and I use often search, but typically use the TOC to have
an idea of the document's content. It also helps me to evaluate the
importance of the subject that I'm searching for. If my keywords appear in
the TOC as a section title, it means that the document has a lot to say
about the subject.

I think that our users and me are using more and more the search tool to
look for topics, but I think the TOC plays it role in the document
navigation and as an abstract of the document's content.

--
Paula Cristina Vaz
<https://www.l2f.inesc-id.pt/wiki/index.php/Paula_Cristina_Vaz>

âTime is God's messenger.â
-- Pope Francis in *The Joy of the Gospel*



On Thu, Jul 10, 2014 at 8:36 PM, Andrew Harvie <withanie -at- gmail -dot- com> wrote:

> Based on purely anecdotal evidence, I suspect that many of the people using
> my documentation are using the Search function to the exclusion of all
> other means of navigation. Heck, even I turn to the search before the
> table of contents.
>
> This might be evidence that I've created a lousy TOC, but I wonder if it
> isn't also a trend in how people look for information. I've heard that many
> people will enter URLs into the Google search field instead of the address
> field and will search for what they already know how to find.
>
> Just wondering if this is anyone else's experience, and if so, what if
> anything, are you doing to improve the search experience for your readers?
>
> My HAT gives me the option of creating context filters for the search, and
> I'm considering a smallish number of filters that more or less duplicate
> the major sections of the TOC, which is already organized primarily by user
> task. Or, perhaps the filters should be feature-based rather than
> task-based?
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Read about how Georgia System Operation Corporation improved teamwork,
> communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as paula -dot- vaz -at- inesc-id -dot- pt -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
>

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l

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

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:
Is Search replacing the TOC and Index?: From: Andrew Harvie

Previous by Author: LinkedIn invitations - accept "unpersonalized" ones ?
Next by Author: RE: LinkedIn invitations - accept "unpersonalized" ones ?
Previous by Thread: Re: Is Search replacing the TOC and Index?
Next by Thread: RE: Is Search replacing the TOC and Index?


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


Sponsored Ads
http://www.techwr-l.com/archives/1407/techwhirl-1407-00037.html
www.techwr-l.com
crawl=CC-MAIN-2019-18
27118
application/http; msgtype=response
sha1:XJCAJ3HWIICCCJOTF5GMNZHVMZJZ5JRJ
<urn:uuid:bc427ae6-d0b5-4750-8478-bad0d77ab94a>
2019-04-21T00:12:17Z
184.106.92.169
text/html
sha1:ZC2EQPYLAJOJUFXZ7PB6IJNLDR4HVPOS
<urn:uuid:b8f55fef-2db4-450b-a8f5-ad8b1fc72168>
http://www.techwr-l.com/archives/1407/techwhirl-1407-00037.html
response
<urn:uuid:f07e3703-9509-46df-b440-b094fca78c3b>
isPartOf: CC-MAIN-2019-18
publisher: Common Crawl
description: Wide crawl of the web for April 2019
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-93-200-49.ec2.internal
software: Apache Nutch 1.15 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 1.1-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: http://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/