Bug 156795 - Avoid using typesetter language "widow" and "orphan"
Summary: Avoid using typesetter language "widow" and "orphan"
Status: RESOLVED FIXED
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Writer (show other bugs)
Version:
(earliest affected)
24.2.0.0 alpha0+
Hardware: All All
: medium normal
Assignee: Samuel Mehrbrodt (allotropia)
URL:
Whiteboard: target:24.2.0
Keywords:
Depends on:
Blocks: Writer-Styles-Paragraph
  Show dependency treegraph
 
Reported: 2023-08-17 07:08 UTC by Samuel Mehrbrodt (allotropia)
Modified: 2024-01-28 02:31 UTC (History)
6 users (show)

See Also:
Crash report or crash signature:


Attachments
Widow/Orphan Control in Wird 2016 (13.31 KB, image/png)
2023-08-17 17:17 UTC, Mike Kaganski
Details
Indesign Widow/Orphan options (198.24 KB, image/png)
2023-08-18 06:28 UTC, Samuel Mehrbrodt (allotropia)
Details
Suggested changes in LO (12.96 KB, image/png)
2023-08-18 06:34 UTC, Samuel Mehrbrodt (allotropia)
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Samuel Mehrbrodt (allotropia) 2023-08-17 07:08:55 UTC
Writer -> Styles -> Edit Style -> Text Flow

There are the following options at the bottom of the page:

Options
- [ ] Do not split paragraph
- [ ] Keep with next paragraph
- Orphan control _2_ lines
- Widow control _2_ lines

"Orphan" and "Widow" are typesetter terms which are well known in the typesetting sphere, but unknown and confusing to the average user.

Instead of using these terms, we should use descriptive terms. Note that Word, InDesign avoid using the terms "Orphan" and "Widow" too.

I would suggest reorganizing/renaming the options as follows:

Options
- [ ] Keep with next paragraph

Don't split paragraph
- [ ] All lines in the paragraph
- Beginning of paragraph : _2_ lines
- End of paragraph: _2_ lines
Comment 1 m_a_riosv 2023-08-17 09:28:45 UTC
Sounds fine, but I think better maintain between parenthesis the original words.
Comment 2 V Stuart Foote 2023-08-17 11:10:54 UTC
(In reply to m.a.riosv from comment #1)
> Sounds fine, but I think better maintain between parenthesis the original
> words.

+1 for retaining them in parenthesis, and there will need to be adjustment to the help article(s).
Comment 3 Heiko Tietze 2023-08-17 11:14:50 UTC
Either I repeatedly forgot to save or BZ is refusing my input.

This topic has been discussed recently in bug 156109 (together with a slight redesign).

*** This bug has been marked as a duplicate of bug 156109 ***
Comment 4 Mike Kaganski 2023-08-17 11:20:38 UTC
(In reply to Heiko Tietze from comment #3)
> This topic has been discussed recently in bug 156109 (together with a slight
> redesign).
> 
> *** This bug has been marked as a duplicate of bug 156109 ***

I don't quite follow the idea (turning into reality from time to time, this being not the first), to take a bug asking for something *different* (tdf#156109), and reuse it for another request - and mark that other request as its duplicate.

Please! The OP in tdf#156109 had *never* asked for a rename. They may have absolutely no desire to rename these; you don't even know, maybe they would *oppose* this new idea. But you effectively destroy that request. It would be OK to close it WF if so decided - but this action masks, hides the request; in the end, it could pretend to *implement* that request...

Please do not!
Comment 5 Samuel Mehrbrodt (allotropia) 2023-08-17 11:55:25 UTC
(In reply to m.a.riosv from comment #1)
> Sounds fine, but I think better maintain between parenthesis the original
> words.

Would a tooltip with the original words also be ok?
Comment 6 Heiko Tietze 2023-08-17 12:16:09 UTC Comment hidden (off-topic)
Comment 7 Mike Kaganski 2023-08-17 12:37:54 UTC
(In reply to Samuel Mehrbrodt (allotropia) from comment #5)
> Would a tooltip with the original words also be ok?

Just a note, that tooltips in dialogs are only shown when extended tooltips are enabled in options (off by default).
Comment 8 Samuel Mehrbrodt (allotropia) 2023-08-17 13:04:43 UTC
(In reply to Mike Kaganski from comment #7)
> (In reply to Samuel Mehrbrodt (allotropia) from comment #5)
> > Would a tooltip with the original words also be ok?
> 
> Just a note, that tooltips in dialogs are only shown when extended tooltips
> are enabled in options (off by default).

Works for me also with extended tips disabled.

Patch is up here: https://gerrit.libreoffice.org/c/core/+/155769
Comment 9 Heiko Tietze 2023-08-17 13:07:53 UTC
(In reply to Samuel Mehrbrodt (allotropia) from comment #8)
> Patch is up here: https://gerrit.libreoffice.org/c/core/+/155769

Would be nice if you also add some indentation to the orphan/widow options as discussed in the non-duplicate.
Comment 10 Mike Kaganski 2023-08-17 13:12:38 UTC
(In reply to Samuel Mehrbrodt (allotropia) from comment #8)
> Works for me also with extended tips disabled.

I confirm - seems like my memory is failing me :-D
Comment 11 jan d 2023-08-17 16:50:10 UTC
> Note that Word, InDesign avoid using the terms "Orphan" and "Widow" too.

What do they use instead?
Comment 12 Mike Kaganski 2023-08-17 17:17:45 UTC
Created attachment 189012 [details]
Widow/Orphan Control in Wird 2016

(In reply to jan d from comment #11)
> > Note that Word, InDesign avoid using the terms "Orphan" and "Widow" too.
> 
> What do they use instead?

No idea about InDesign; and no idea about newer Word; but here is the Widow/Orphan Control checkbox in Word 2016.
Comment 13 Kazinator 2023-08-17 17:32:31 UTC
> Please! The OP in tdf#156109 had *never* asked for a rename. They may have
> absolutely no desire to rename these; you don't even know, maybe they would
> *oppose* this new idea. But you effectively destroy that request. It would
> be OK to close it WF if so decided - but this action masks, hides the
> request; in the end, it could pretend to *implement* that request...
> 
> Please do not!

I am that OP, and that is not true. I share the exact opinion of the OP of this bug. Somewhere in #156109, I wrote these words, which are exactly the topic of this item:

Kazinator> Orphan and Widow are some kind of typesetting jargon whose metaphor not 
Kazinator> everyone might understand[.]


This like when the UI in Android phones warns the user that a SD card was not unmounted before being removed, expecting the population to be familiar with Unix jargon and commands.

:)

However, it is true that I did not make terminology the focus of #156109.

The terminology, as such, is fine. Software can play a role in teaching users concepts and terminology. You can have "widow" and "orphan" if there is some tooltip, "learn more ..." link or whatever where they can get an explanation what that means.

If you're a domain expert writing software, you can use its user interface and documentation to educate users in that domain (alongside having the software perform it "payload" tasks). You don't have to dumb down all the terminology so that other domain experts are confused or find it ridiculous, and you don't have to alienate users who don't understand the jargon.

Where do you draw the line between typesetting jargon that is acceptable to Joe Sixpack and that is too advanced?

How about "hanging indentation", "margin", "justification", "drop caps", "kerning" ...
Comment 14 Mike Kaganski 2023-08-17 19:28:54 UTC Comment hidden (off-topic)
Comment 15 Samuel Mehrbrodt (allotropia) 2023-08-18 06:28:15 UTC
Created attachment 189018 [details]
Indesign Widow/Orphan options

(In reply to jan d from comment #11)
> > Note that Word, InDesign avoid using the terms "Orphan" and "Widow" too.
> 
> What do they use instead?

"Keep lines together" (See screenshot in attachment).
Comment 16 Samuel Mehrbrodt (allotropia) 2023-08-18 06:34:58 UTC
Created attachment 189019 [details]
Suggested changes in LO

This is my try to implement the term change and the improvements from bug 156109.

The tooltips are as follows:

"Number of lines, that will be kept together at the beginning of the paragraph (orphan control)."

"Number of lines, that will be kept together at the end of the paragraph (widow control)."
Comment 17 Commit Notification 2023-08-18 13:24:27 UTC
Samuel Mehrbrodt committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/core/commit/47edf86a62784aa275de7cc89df01a4fcd4e90c8

tdf#156795, tdf#156109 Avoid typesetter language: orphan, widow control

It will be available in 24.2.0.

The patch should be included in the daily builds available at
https://dev-builds.libreoffice.org/daily/ in the next 24-48 hours. More
information about daily builds can be found at:
https://wiki.documentfoundation.org/Testing_Daily_Builds

Affected users are encouraged to test the fix and report feedback.
Comment 18 LeroyG 2023-08-21 00:09:49 UTC
(In reply to Samuel Mehrbrodt (allotropia) from comment #0)

> I would suggest reorganizing/renaming the options as follows:

My suggestion:

Options
[ ] Keep with next paragraph

[ ] Split paragraph
  Minimum amount of lines to be kept together:
- At the bottom of the previous column/page: _2_ lines
- At the top of the next column/page: _2_ lines

Wording taken from:
https://help.libreoffice.org/latest/en-US/text/shared/00/00000005.html?&DbPAR=SHARED#hd_id3166423

I have reopened the bug. Sorry if not done in the proper way.
Comment 19 Heiko Tietze 2023-08-21 06:53:59 UTC
(In reply to LeroyG from comment #18)
> My suggestion:
> 
> Options
> [ ] Keep with next paragraph
> 
> [ ] Split paragraph
>   Minimum amount of lines to be kept together:
> - At the bottom of the previous column/page: _2_ lines
> - At the top of the next column/page: _2_ lines

(In reply to Heiko Tietze from bug 156109 comment #7)
> (In reply to Kazinator from comment #6)
> > I think when we have pared down three choices down to two, we can revert
> > back to a checkbox:
> > 
> >   [x] Allow paragraph to be split
> >       [ ] Orphan control [   ]
> >       [ ] Widow control  [   ]
> >   [x] Keep with next paragraph

Aside from the changed labels this was agreed on / suggested in the other ticket. Just to mention the indentation.
Comment 20 Samuel Mehrbrodt (allotropia) 2023-08-25 08:50:08 UTC
Please discuss additional changes in the Design Meeting. If need be, change the UI file directly.