Bug 137281 - Clarify what "heading" means in Writer
Summary: Clarify what "heading" means in Writer
Status: RESOLVED FIXED
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
unspecified
Hardware: All All
: medium normal
Assignee: Not Assigned
URL:
Whiteboard: target:7.6.0
Keywords:
Depends on: 137829 Clarify-Chapter-Heading-Outline-Level
Blocks:
  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:


Attachments

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
https://help.libreoffice.org/latest/en-US/text/swriter/01/05030800.html

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.

https://help.libreoffice.org/7.0/en-US/text/swriter/01/06060100.html
https://help.libreoffice.org/7.0/en-US/text/swriter/guide/chapter_numbering.html
Comment 5 sdc.blanco 2023-02-11 23:24:02 UTC
Add "Heading" to General Glossary (bug 153547)

https://gerrit.libreoffice.org/c/help/+/146796
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":

https://git.libreoffice.org/help/commit/fbc1e41ad4961b502ca658e2f19e74450c93c76c

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":

https://git.libreoffice.org/help/commit/19870562065899332b16070b6724d628f8d1cb80

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":

https://git.libreoffice.org/help/commit/8a84febe0937a59a893cf3c08c310233c1339bfa

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