Bug 156072

Summary: "Numbering followed by" documentation mentions an option not found in the software
Product: LibreOffice Reporter: William Friedman <will.friedman>
Component: DocumentationAssignee: Not Assigned <libreoffice-bugs>
Status: NEW ---    
Severity: normal CC: olivier.hallot
Priority: medium    
Version: 7.5.3.2 release   
Hardware: All   
OS: All   
See Also: https://bugs.documentfoundation.org/show_bug.cgi?id=112384
Whiteboard:
Crash report or crash signature: Regression By:
Bug Depends on:    
Bug Blocks: 120200    

Description William Friedman 2023-06-27 03:29:40 UTC 
Description:
At https://help.libreoffice.org/7.5/en-US/text/shared/01/06050600.html?&DbPAR=WRITER&System=WIN the documentation says: 

"Numbering followed by

Select the element that will follow the numbering: a tab stop, a space, a line break, or nothing."

Line break is not an option the version of LO the documentation purports to refer to.

Steps to Reproduce:
1. Go to the documentation link mentioned above.
2. See that Bullets and Numbering | Numbering followed by does not have a line break option.

Actual Results:
Documention does not match the software.

Expected Results:
The documentation should match the software.


Reproducible: Always


User Profile Reset: No

Additional Info:
Version: 7.5.3.2 (X86_64) / LibreOffice Community
Build ID: 9f56dff12ba03b9acd7730a5a481eea045e468f3
CPU threads: 4; OS: Windows 6.1 Service Pack 1 Build 7601; UI render: Skia/Raster; VCL: win
Locale: en-US (en_US); UI: en-US
Calc: CL threaded
Comment 1 Mike Kaganski 2023-06-27 06:36:21 UTC 
It might need a clarification, that the line break only applies to one of the list of "To access this command..." in the article. However, it is not "an option not found in the software" - it is in the Chapter Numbering.
Comment 2 William Friedman 2023-06-27 13:41:33 UTC 
Ah, I see now. Thank you for the clarification.

I think this might be related to a bigger problem, the total conflation of chapter numbering with list numbering, when the former has options not associated with the latter. For example, I searched in the online help for "chapter" in module Writer. One of the matches was "changing -- chapter levels" which I then clicked on, while pulled up this: https://help.libreoffice.org/latest/en-US/text/swriter/guide/insert_tab_innumbering.html?DbPAR=WRITER#bm_id3145078. There it says "To insert a tab between the number or bullet and the paragraph text for all list paragraphs at a given list level, use the Numbering followed by option in the Position tab in the Bullets and Numbering dialog."

So I tried it by setting the style to Heading 1, and then pulled up the Position Tab in the Bullets and Numbering dialog as indicated. Because this is the standard Bullets and Numbering dialog and not the special Chapter Numbering one, "line break" is not an option for "Numbering followed by", despite the fact that I am trying to set the Numbering options for a chapter heading style, and followed a link in the help that came up when I searched for "chapter"!

I'm not sure if this is best characterized as a documentation problem or an UI problem or both. Certainly, though, if I'm hitting a link in the help that is supposed to talk about chapter numbering, it should lead me to the options that pertain to chapter numbering specifically, especially if they're different than the options for regular list numbering.