Bug 141988

Summary:	Online help pages don't indicate their context/hierarchy position
Product:	LibreOffice	Reporter:	Eyal Rozenberg <eyalroz1>
Component:	Documentation	Assignee:	Not Assigned <libreoffice-bugs>
Status:	RESOLVED NOTABUG
Severity:	normal	CC:	olivier.hallot
Priority:	medium
Version:	7.1.2.2 release
Hardware:	All
OS:	All
See Also:	https://bugs.documentfoundation.org/show_bug.cgi?id=141990
Whiteboard:
Crash report or crash signature:		Regression By:

Description Eyal Rozenberg 2021-04-30 09:36:28 UTC

Consider this help page:

https://help.libreoffice.org/7.2/en-US/text/shared/02/02050000.html?&DbPAR=WRITER

It says:

> Text running from top to bottom
> 
> Specifies the vertical direction of the text.

that's an interesting tidbit of information. But - where is this control localed? Is it a toolbar button? A dialog button? Which LO module presents it?

If I knew this help item was in, say,

LO Help > Writer > Toolbars > Formatting 

(it isn't, I'm just making that hierarchy up) then I would know. Alternatively, there could be at least a link to the help page of the containing element/dialog/menu/toolbar.

This is particularly problematic when you locate help pages using the search, rather than through browsing.

Comment 1 Olivier Hallot 2021-04-30 11:49:21 UTC

This page is an auxiliary page for embedding contents in other pages

<section id="sytext_top_to_bottom">

is called by 

scalc/main0205.xhp:<embed href="text/shared/02/02050000.xhp#sytext_top_to_bottom"/>
simpress/main0203.xhp:      <embed href="text/shared/02/02050000.xhp#sytext_top_to_bottom"/>
swriter/main0220.xhp:<embed href="text/shared/02/02050000.xhp#sytext_top_to_bottom"/>

or, in built help online

https://help.libreoffice.org/7.2/en-US/text/swriter/main0220.html
https://help.libreoffice.org/7.2/en-US/text/scalc/main0205.html?DbPAR=CALC
https://help.libreoffice.org/7.2/en-US/text/simpress/main0203.html?DbPAR=IMPRESS

The icon is displayed in the Text Object Toolbar, when CTL/Asiatic languages are enabled.

Setting "not a bug".

Reopen if you want to add precision on the page contents by supplying in this ticket the text you want to read in the page.

Comment 2 Eyal Rozenberg 2021-04-30 12:06:18 UTC

(In reply to Olivier Hallot from comment #1)
> This page is an auxiliary page for embedding contents in other pages

Then why does it exist, and is viewable, on its own?

> Reopen if you want to add precision on the page contents by supplying in
> this ticket the text you want to read in the page.

Not exactly, I was using it just as an example.