Issue 59660 - The "Contents" tree is not synchronized with right pane
Summary: The "Contents" tree is not synchronized with right pane
Status: CONFIRMED
Alias: None
Product: documentation
Classification: Unclassified
Component: Online help (show other issues)
Version: OOo 2.0
Hardware: All Windows NT
: P3 Trivial (vote)
Target Milestone: 4.x
Assignee: AOO issues mailing list
QA Contact:
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-12-22 04:50 UTC by raindrops
Modified: 2013-02-07 21:48 UTC (History)
1 user (show)

See Also:
Issue Type: ENHANCEMENT
Latest Confirmation in: ---
Developer Difficulty: ---


Attachments

Note You need to log in before you can comment on or make changes to this issue.
Description raindrops 2005-12-22 04:50:06 UTC
In the help file, the "Contents" tree (in the "Contents" tab) is not
synchronized with the pages displayed in the right pane. The tree is designed to
work "one way only": A click on any node of the tree opens up the text, but if
you have reached a page through the Index/Find tabs, the tree does not show the
current page's location. 

As a direct consequqnce of this, the reader cannot read the relevant
chapter(from the current page, he can't go to the next/previous page to look up
closely related topics.)

This severely affects the usability of the help file.

Compare this with a help file created in CHM or pdf format: At any time, the
user knows where he is. The bookmark panel on the left shows his current
location in the book clearly, and he can navigate to the other parts of the
file. He can also go to the previous/next page (Navigation controls for going to
the "Previus" and "Next" pages are provided.)

Also compare this with a PRINTED book: The reader can look up a word from TOC or
index, and go straight to the relevant chapter and start reading. He can also
read any other related topics which would be there in the same chapter.

In all the three examples, the reader gets a complete, flowing description of
what is happening, and why.

In contrast, the OOo help file's "Find" or "Index" tabs behave as if a single
page is torn off and given to the reader! The reader's access to the current
chapter is BLOCKED!

*********
Step-by-step procedure to replicate the problem:
1. Press F1 in OOo to start the help file.
2. Switch to "Index" tab.
3. Enter a keyword. 
   OOo lists matching entries in the bottom half of the left pane.
4. Double-click on any entry. 
   OOo loads the relevant page in the right pane.

But the problem lies here: You can read only THIS (current) page; but NOT the
chapter that explains other closely relevant topics. You cannot go to the
previous/next page to read that part of the help file.

5. Click on the "Contents" tab. 

You would expect to see the current page's location (node) highlighted there;
and if this is a sub-node (low in the hierarchy), the tree should be opened up
sufficiently to reveal that sub-node.

But this does not happen: You simply do NOT know where you are at the moment.
Comment 1 frank.thomas.peters 2005-12-22 08:48:15 UTC
Thanks for your comments.

It works as designed. I agree that this would be a very useful feature but it
needs to be implemented by engineering so I'll reassign this.


Comment 2 frank.thomas.peters 2005-12-22 08:49:17 UTC
confirmed
Comment 3 andreas.bille 2006-05-22 10:49:55 UTC
accepted
Comment 4 kai.sommerfeld 2006-06-15 15:21:50 UTC
.
Comment 5 kai.sommerfeld 2006-10-20 08:34:59 UTC
=> Target now 2.2.
Comment 6 andreas.bille 2007-01-15 10:27:30 UTC
The synchronization is not in every case possible, because the help content ist
not organzid in book form, making it impossible to assign a chapter to every page.
Comment 7 raindrops 2007-01-15 16:36:32 UTC
A separate chapter for each page is NOT required. 

However, the tree MUST have a separate node for each page. When any page is
displayed in the right pane, that node should be highlighted automatically in
the tree.

For example, suppose that my search results in a list of 10 topics. If I
double-click on any one of them, the page opens. At this time, if I open the
tree, the node for the current page should be already highlighted. Now I can go
backwards in the tree to read the related pages.
Comment 8 Uwe Fischer 2007-01-16 09:23:03 UTC
No such tree related page hierarchy exists for the online help pages. They are
just a set of files. Everyone is invited to define a page order and hierarchy,
see our to do list at
http://wiki.services.openoffice.org/wiki/Application_Help_Development_To_Do
In OOo 3, we will have only those pages in the Contents tab that are currently
located in the guides folders.
Comment 9 raindrops 2007-01-16 13:39:47 UTC
I think hierarchy of nodes is not relevant here at all! 

As long as each page is represented in the tree by a node, it is OK!
Comment 10 andreas.bille 2007-04-04 14:28:54 UTC
ABI->AB: As discussed ...
Comment 11 ab 2007-04-19 12:32:21 UTC
STARTED
Comment 12 ab 2007-11-16 14:23:14 UTC
ab->pb: Wouldn't this enhancement mainly refer to the help viewer?
Comment 13 Mathias_Bauer 2008-01-14 09:09:39 UTC
target 3.x