Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
RE: [platform-help-dev] Navigation view - would like to have user -defined filtering

Re: Searching
-------------
It would be nice to have the following search options available to the user:
1) search all in doc.zip (p2), so as to include topics not linked into TOC
2) search in current hierarchy only (p2), as per Dorian's earlier suggestion
3) search on selected nav nodes (p3), involving a specialized node selection
i/f 
4) search on filtered-in topics (p3), discussed below ... see 'Filtering'
Plus the additional 'AND'ed option of searching headings only in whatever
topics are selected for search (p2).

Notes: 
- Implementation of option (4) would do away with the need for option (3),
but (3) could be left in place as a refined search within the filtered-in
set of topics. 
- In the previous, unofficial search engine for Eclipse 1.0, there were two
standard search features available in the Advanced dialog: "Enable filtering
on:", which provided a separate node selection i/f that allowed user to pick
nav nodes on which to search, and "Search headings only". It would be nice
if these capabilities are available in some capacity in the new Eclipse 2.0
search utility just to maintain 'existing' functionality. This would make
them p2 items in my book, as I've indicated above. It seems that I had best
enter these in bugzilla...

Re: Filtering
-------------
It would be nice to have a filter interface and the following filter-in
options available to the user (these would impact both search and display of
TOC nav nodes):
1) filter in topics based on selected nav nodes (p2)
2) filter in topics based on selected information types (p3)
3) filter in topics based on selected predefined filters (p3)

Filter options (2) and (3) would assume that you might consider supporting
information-type mark-up or labelling associated with topics. Filter option
(3) would assume that you might consider enabling some mechanism by which
the help system author can set up predefined filters. Initially, this could
involve just selecting TOC/nav nodes, but (for future consideration) would
most effectively be based on information typing, such as user role (e.g.,
analyst, developer, tester) or topic type (e.g., get started, concepts,
reference, task).  I can see that both of these requests would probably
involve considerably more complexity in the help system since it would
likely involve some sort of additional topic mark-up or tagging, and then
supporting mechanisms in the help engine....  and so they would be p3 items.
Bugzilla?

My $0.02 (Cdn)
Christal


-----Original Message-----
From: birsan@xxxxxxxxxx [mailto:birsan@xxxxxxxxxx]
Sent: Sunday, March 17, 2002 9:55 AM
To: platform-help-dev@xxxxxxxxxxx
Subject: Re: [platform-help-dev] Navigation view - would like to have
user-defined filtering



Agreed.

We may need to reconsider adding  a Search action on a topic's context
menu, that would search the topic subtree rooted at that topic.

-dorian



 

                    Greg_Adams@xxxxxxx

                    Sent by:                        To:
platform-help-dev@xxxxxxxxxxx

                    platform-help-dev-admin@e       cc:

                    clipse.org                      Subject:     Re:
[platform-help-dev] Navigation view - would like to have user-defined 
                                                     filtering

 

                    03/16/2002 12:04 PM

                    Please respond to

                    platform-help-dev

 

 





There are cases where a beginner user could get value out of this, not just
an advanced user. For example when using a product I wanted to search for a
given word within the getting started and didn't want all of other hits.
Similarly there were cases where I was looking for sample walkthroughs that
mentioned some other word.

I would however rate this as a p3 (future) item.

/Greg


                                                                          
   birsan@xxxxxxxxxx                                                      
   Sent by:                       To:                                     
   platform-help-dev-admi platform-help-dev@xxxxxxxxxxx                   
   n@xxxxxxxxxxx                  cc:                                     
                                  Subject:        Re: [platform-help-dev] 
                          Navigation view - would like to have            
   03/15/2002 07:35 PM    user-defined filtering                          
   Please respond to                                                      
   platform-help-dev                                                      
                                                                          





A couple of questions:

  Should search return hits from the current view only or from the entire
  documentation?
  Filtering large amounts of information (like documentation) is a very
  good idea, but I think that filtering of arbitrary subtrees is a bit
  dangerous, as it would imply too much knowledge of what's inside. I
  would think that a top level filtering would suffice. Should the
  filtering set be the same as for search? (that's related to the first
  question)

BTW,  please open a feature in bugzilla so we can track it.
-dorian




                   Leigh

                   Davidson/Toronto/IBM@IBMC       To:
platform-help-dev@xxxxxxxxxxx

                   A                               cc:

                   Sent by:                        Subject:
[platform-help-dev] Navigation view - would like to have user-defined
                   platform-help-dev-admin@e        filtering

                   clipse.org


                   03/15/2002 02:16 PM

                   Please respond to

                   platform-help-dev






Suggestion for future release: In the navigation tree, allow me to select
nodes for filtering. This would allow advanced users, for example, to block
out beginner topics that they're not interested in any more, so they no
longer have to scroll down the nav to the chunks that they use 80% of the
time. Or, in a product that ships interfaces for 10 kinds of back-end
system, I could select to view only the ones that I'm interested in - save
some real estate.

My first idea for this was to right-click on the node and have a
checked/unchecked menu item like "Hide from Navigation/Show in Navigation."
(Another idea is an "Add to Favorites" option.) But I realize there is a
model for other views in the workbench - incl Navigator and Tasks - to
provide filtering my means of the "Menu" toolbar button (the inverted
triangle), which has Filter as a selection on its drop-down menu, which in
turn opens a dialog box where the user selects and clears check boxes. So
maybe the Help view should be consistent with the behavior of these other
views.

If you could provide something like this, I think there should be a clear
visual indication that I am currently viewing a subset of the information.
Not sure how you would do that. Maybe tabs - View All, View Favorites.

I think the Synchronize button in a help document should synchronize to the
"All" view?

Leigh Davidson
Editor, IBM Canada Lab

_______________________________________________
platform-help-dev mailing list
platform-help-dev@xxxxxxxxxxx
http://dev.eclipse.org/mailman/listinfo/platform-help-dev



_______________________________________________
platform-help-dev mailing list
platform-help-dev@xxxxxxxxxxx
http://dev.eclipse.org/mailman/listinfo/platform-help-dev




_______________________________________________
platform-help-dev mailing list
platform-help-dev@xxxxxxxxxxx
http://dev.eclipse.org/mailman/listinfo/platform-help-dev


Back to the top