Bug 137281 - Clarify what "heading" means in Writer
Summary: Clarify what "heading" means in Writer
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
(earliest affected)
Hardware: All All
: medium normal
Assignee: Not Assigned
Whiteboard: target:7.6.0
Depends on: 137829 Clarify-Chapter-Heading-Outline-Level
  Show dependency treegraph
Reported: 2020-10-06 06:49 UTC by Mike Kaganski
Modified: 2023-03-04 12:34 UTC (History)
4 users (show)

See Also:
Crash report or crash signature:


Note You need to log in before you can comment on or make changes to this bug.
Description Mike Kaganski 2020-10-06 06:49:40 UTC
We need to clarify in help, what "Heading" is meant that appears in different places. See bug 137273 which shows user confusion because of misunderstanding this concept.

"Cross-references" help article [1] mentions it without any explanation:

> Headings  The Selection box shows a list of all headings in the order of
>           their appearance in the document.

We need to clarify that "Heading" for writer is any paragraph which has Outline level other than Text Body (with a reference to the corresponding paragraph property tab); and that *by default*, Heading N paragraph styles have that property set accordingly. That would give required technical background, and hint that the default setting may be changed, thus changing the behaviour of the field function.

"Index" help article [2] mentions outline levels; still, a direct reference to the corresponding paragraph property would help, and also addition that the paragraph styles are only added *when their outline levels are set, which is true by default*.

There may be other places that could benefit from this clarification.

[1] https://help.libreoffice.org/7.0/en-US/text/swriter/01/04090002.html
[2] https://help.libreoffice.org/7.0/en-US/text/swriter/01/04120211.html
Comment 1 Xisco Faulí 2020-10-06 10:54:34 UTC
Seems reasonable
Comment 3 Mike Kaganski 2020-10-07 05:17:01 UTC

This article also does not describe what "Outline" means.

> Assigns an outline level from 1 to 10 to the selected paragraphs or
> Paragraph Style. Select Text Body to reset the outline level.

No mention why would anyone want to change "outline level", and what would it affect.
Comment 4 Mike Kaganski 2020-10-07 06:39:17 UTC
"Chapter Numbering" feature is tightly connected here.

Bug 107573 had renamed the old "Outline Numbering" into "Chapter Numbering". That broke linguistical connection between the Outline Level property and the feature.

We need to describe, that it's this feature that creates the default assignment of Outline Levels to pre-defined Heading N paragraph styles. Also we need to clarify that this feature makes the level fixed for the chosen paragraph style (i.e., it cannot be modified in paragraph style dialog), and when a style is unassigned in Chapter Numbering, that style looses the outline level.

Comment 5 sdc.blanco 2023-02-11 23:24:02 UTC
Add "Heading" to General Glossary (bug 153547)

Comment 6 Commit Notification 2023-02-17 15:27:02 UTC
Seth Chaiklin committed a patch related to this issue.
It has been pushed to "master":


tdf#153547 (related: tdf#137281) add "heading" to General Glossary
Comment 7 Commit Notification 2023-02-18 03:04:09 UTC
Seth Chaiklin committed a patch related to this issue.
It has been pushed to "master":


tdf#152605, tdf#137281 change "heading level" to "outline level"
Comment 8 Commit Notification 2023-03-04 12:34:08 UTC
Seth Chaiklin committed a patch related to this issue.
It has been pushed to "master":


tdf#137281, tdf#153549  clarify use of heading and chapter