Bug 94303

Summary: Bad usability of the links in the bottom link bar
Product: [Websites] docs.kde.org Reporter: Jörg Hoh <joerg>
Component: generalAssignee: Documentation Editorial Team <kde-doc-english>
Status: RESOLVED FIXED    
Severity: wishlist    
Priority: NOR    
Version: unspecified   
Target Milestone: ---   
Platform: Gentoo Packages   
OS: Linux   
Latest Commit: Version Fixed In:
Sentry Crash Report:

Description Jörg Hoh 2004-12-03 00:32:22 UTC
Version:            (using KDE KDE 3.3.1)
Installed from:    Gentoo Packages
OS:                Linux

The blue link bar (white font, blue background) on the bottom of every help page has 2 flaws:

a) "prev" (why don't you write it "previous") and "next" have 2 meanings. It can be the last/next page (like in a book), or it can be the last/next page in the history (if you use the help system as a hypertext system). Can you make this much clearer? Perhaps replace it by an icon?

b)Below the prev- and next-Link is the name of the previous/next page in the same color as the clickable link "prev" and "next", but the name isn't a link. The User gets confused. Plase change the color of that name.

A small third point: What does "home" mean? My home is my castle? Or the first page of the "book" aka the toplevel page of the help system? The user can mistake that "home" for the "Home" Icon of the desktop.)
Comment 1 Anders Lund 2004-12-03 00:56:22 UTC
On Friday 03 December 2004 00:32, Jörg Hoh wrote:
> a) "prev" (why don't you write it "previous") and "next" have 2 meanings.
> It can be the last/next page (like in a book), or it can be the last/next
> page in the history (if you use the help system as a hypertext system). Can
> you make this much clearer? Perhaps replace it by an icon?

By tradition, 'next' and 'previous' are context bound, while 'back' and 
'forward' is history bound.

> b)Below the prev- and next-Link is the name of the previous/next page in
> the same color as the clickable link "prev" and "next", but the name isn't
> a link. The User gets confused. Plase change the color of that name.

It should be a link. Having the text is nice, on a side note I allways found 
the *tradition* of not showing the title for the next/previous pages in the 
top of the page strange -- why am i supposed to be more interrested in where 
'next' is in the bottom of the page??? A nice link form of the link text 
would be 'logic-place: title' ("next: Introdoction" etc)

> A small third point: What does "home" mean? My home is my castle? Or the
> first page of the "book" aka the toplevel page of the help system? The user
> can mistake that "home" for the "Home" Icon of the desktop.)

Guess once... Of cause any docbook generated file contains a link to your home 
directory... The name 'home' is a tradition too. Maybe 'Front page' would be 
nicer?

Comment 2 Jörg Hoh 2004-12-04 13:19:30 UTC
>> A small third point: What does "home" mean? My home is my castle? Or the 
>> first page of the "book" aka the toplevel page of the help system? The user 
>> can mistake that "home" for the "Home" Icon of the desktop.) 
 
> Guess once... Of cause any docbook generated file contains a link to 
> your home  directory... The name 'home' is a tradition too. Maybe 'Front
> page' would be nicer? 

"Home" may be confusing, so "Front page" would be much better.
Comment 3 Philip Rodrigues 2005-07-28 15:40:43 UTC
"Contents" seems best. If there's agreement on this, I'll change it in the XSL.
Comment 4 Marek Laane 2007-08-01 23:43:45 UTC
There is still Home...
(BTW, i do not find it confusing but of course Contents may be more clear...)
Comment 5 Philip Rodrigues 2007-08-02 00:52:25 UTC
SVN commit 695365 by philrod:

Use "Contents" instead of "Home" for the links on each doc page

BUG:94303


 M  +1 -1      en.xml  


--- trunk/KDE/kdelibs/kdoctools/docbook/xsl/common/en.xml #695364:695365
@@ -156,7 +156,7 @@
    <l:gentext key="ListofTables" text="List of Tables"/>
    <l:gentext key="ListofUnknown" text="List of Unknown"/>
    <l:gentext key="listofunknown" text="List of Unknown"/>
-   <l:gentext key="nav-home" text="Home"/>
+   <l:gentext key="nav-home" text="Contents"/>
    <l:gentext key="nav-next" text="Next"/>
    <l:gentext key="nav-next-sibling" text="Fast Forward"/>
    <l:gentext key="nav-prev" text="Prev"/>