https://bugs.documentfoundation.org/show_bug.cgi?id=173176
--- Comment #5 from RGB <[email protected]> --- (In reply to Eyal Rozenberg from comment #4) > (In reply to RGB from comment #3) > > The paragraph styles available for cross-references & TOC are the ones set > > on one of two places: > > > > 1) under Tools → Heading numbering → Numbering tab > > 2) in the paragraph style definition under *Outline level* in the *Outline & > > List* tab > > Well, this is a bug, because it assumes all headings have a numeric level. > But that is not necessarily the case in every document. And if I write a > document where Headings don't have different ranks or levels - it is > appropriate to use the non-level-enumerated "Heading" style. "Heading numbering" is not about numbering... or not always: you can left the numbering off and everything works. The menu is about the document *structure* and a better name would be just that: document structure. That's why I think we have a naming/documentation problem, calling the option "Heading *numbering*" is misleading. > > > The style names have no real meaning > > Style names have all the meaning in the world. We use a style when its name > fits the content to which we apply it - and refrain from using it when it > doesn't fit. That's true for systems such as LaTeX, where style structure is quite rigid (Part, Chapter, Section, Subsection..., body text... some special styles), but Writer offers absolute freedom to use any set of styles to give structure to the document. > > > The system is easy to use, but difficult to discover. > > Easy or hard - paragraphs having the "Heading" style are headings. And there > is no getting around it. Heading N are the *default* heading styles, but they are not set in stone. Writer allows you to discard those style and pick others, so no, for Writer a paragraph style with "Heading" in the name not necessarily is an actual "heading". There are several points where Writer's naming conventions do not follow what others do; for example, "Section" in Writer have absolutely no relation whatsoever with what LaTeX call a "Section". > > (One could perhaps argue regarding whether, say, Title paragraphs are > headings; although for consistency, and because it's useful to be able to > link to them, and because they're not in another category of link targets - > they probably should be considered headings for this purpose as well.) > > > The problem is, > > perhaps, not about the use of a particular style for a particular task, but > > about naming and documentation of the whole system. > > The problem is that the program's logic doesn't fit the domain logic of > document authoring, which is the logic of humans operating in this domain. > And the solution can't be encouraging the humans to warp their logic to fit > the program. The program's logic is not really that different from other software; it provides a document with a hierarchical structure with different levels, where the top levels are used to group the different parts of the document. The naming conventions can be confusing at first (and "second") glance, and that, I think, is the real problem. -- You are receiving this mail because: You are the assignee for the bug.
