Bug 145398 - Content overview in LO Help is wrong
Summary: Content overview in LO Help is wrong
Status: VERIFIED FIXED
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
unspecified
Hardware: All All
: medium normal
Assignee: Rafael Lima
URL:
Whiteboard: target:7.3.0
Keywords:
Depends on:
Blocks: Help
  Show dependency treegraph
 
Reported: 2021-10-30 07:06 UTC by Dieter
Modified: 2021-12-01 06:11 UTC (History)
2 users (show)

See Also:
Crash report or crash signature:


Attachments
Contents in LO Help (208.02 KB, image/jpeg)
2021-10-30 07:06 UTC, Dieter
Details
Proposed changes (84.76 KB, application/vnd.oasis.opendocument.graphics)
2021-11-18 17:56 UTC, Rafael Lima
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Dieter 2021-10-30 07:06:28 UTC
Created attachment 176018 [details]
Contents in LO Help

Open attached screenshot of Online Help for LO 7.3

Creating Text documents has two subpoints:
- Navigating and Selecting With the Keyboard
- Using the Direct Cursor

I would expect both under "Navigating Text Documents"

I couldn't find subpoint for "Creating Text". I would expect informations about templates here (filed this report after working on bug 145114)
Comment 1 Akshit 2021-11-14 07:24:27 UTC
The two subpoints under the 'Creating Text Documents'section are related to the formatting and/or entering of text into the document. 

While the 'Navigating Text Documents' section is focused on searching/finding pieces of text, moving/copying already entered lines of text, and using the Navigator.

I think this is an important distinction to make (creating lines vs. navigating a document) and combining the two wouldn't make sense.
Comment 2 Dieter 2021-11-14 11:11:26 UTC
(In reply to Akshit from comment #1)
> The two subpoints under the 'Creating Text Documents'section are related to
> the formatting and/or entering of text into the document. 
But why is it part of "Creating Documents"? (If creating is used in a very broad sense, alomost eveything could be part of creating a document)

> While the 'Navigating Text Documents' section is focused on
> searching/finding pieces of text, moving/copying already entered lines of
> text, and using the Navigator.

I agree, but "Navigating and Selecting with the Keyboard" is one aspect of "Navigating Text Documents" (at least for me)
> I think this is an important distinction to make (creating lines vs.
> navigating a document) and combining the two wouldn't make sense.
I also agree, but Navigating and Selecting with the Navigator" and "Using the Direct Cursor" is not about creating new lines. So I don't understand this part of your comment.
Comment 3 Rafael Lima 2021-11-18 17:56:24 UTC
Created attachment 176346 [details]
Proposed changes

I agree that the current tree structure is weird. I attached an ODG file with the proposed changes.

Basically:
1) Move the 2 items under "Creating Text Documents" to "Navigating Text Documents"
2) Remove the entry "Creating Text Documents" since it'll become empty
3) Promote the entry "Templates and Styles" (currently under "Formatting Text Documents") as a main entry below "Text Documents (Writer)"

Let me know your thoughts. Then I'll proceed with a fix.
Comment 4 Dieter 2021-11-20 17:07:37 UTC
(In reply to Rafael Lima from comment #3)
> Created attachment 176346 [details]
> Proposed changes

Looks reasonable to me. 

> 2) Remove the entry "Creating Text Documents" since it'll become empty
I would expect - for example - some informations about how to create a new text document with an existing template. But LibreOffice help doesn't provide such a basic information; see [1] and related topics on that page. So I agree to remove that entry.

[1] https://help.libreoffice.org/7.3/en-GB/text/swriter/guide/templates_styles.html?&DbPAR=WRITER&System=WIN
Comment 5 Commit Notification 2021-11-24 22:31:04 UTC
Rafael Lima committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/help/commit/0e031e14e258d11234dfef5e97245829fad9af49

tdf#145398 Adjustments to the Writer tree
Comment 6 Dieter 2021-12-01 06:11:15 UTC
Looks good in LO 7.3 help! => VERIFIED
Rafael, thanks for fixing it!