[platform-help-dev] What info will be returned on search hit lists?

[ldavidso@xxxxxxxxxx]

I'm not sure how closely this is tied to the search engine that you select
for V2. This posting is to suggest that search hits should display the
<title> tag of the target file, plus possibly some portion of the target
file's body (first few lines or, as google seems to return, snippets of
lines that contain the search arguments).

As Kari Halsted specified in her list of req'ts on Nov 21/2001, the IBM ID
community was previously asking to have <h1> tags returned. In offline
discussion, it was pointed out that different adopters of Eclipse might use
<h_> tags in different ways or might not use them at all, whereas <title>
tags are probably more predictable/appropriate.

Our least favorite option is to return text strings from the table of
contents. We would like to uncouple t.o.c. strings from search hits, so
that we have the option of making t.o.c. entries concise (let users derive
context from parent/grandparent text) but search hits more complete (let
user derive context from the wording of the hit).

Leigh Davidson
Editor, IBM Canada Lab
Phone: 416-313-1034
email: ldavidso@xxxxxxxxxx