Bug 154234

Summary: Clarify the difference between the A,B,C and A,AA,AAA numbering scheme (also a,b,c vs. a,aa,aaa)
Product: LibreOffice Reporter: sdc.blanco
Component: DocumentationAssignee: sdc.blanco
Status: RESOLVED FIXED    
Severity: minor CC: heiko.tietze, olivier.hallot, stephane.guillou, telesto
Priority: low    
Version: 7.6.0.0 alpha0+   
Hardware: All   
OS: All   
See Also: https://bugs.documentfoundation.org/show_bug.cgi?id=152985
Whiteboard: target:7.6.0
Crash report or crash signature: Regression By:
Bug Depends on:    
Bug Blocks: 103369    
Attachments: some numbered headings and an ordered list
screenshot of proposed updating

Description sdc.blanco 2023-03-16 22:51:37 UTC
Created attachment 186018 [details]
some numbered headings and an ordered list

Bullets and Numbering dialog, Customize tab.  (also Heading/Chapter Numbering)

The "Number" dropdown box offers
"A, B, C" and "A.., AA.., AAA..."

They give the same result, if used as a list numbering scheme.
Are they supposed to be different? 
If yes, then a bug (or the documentation has to be improved).
If no, then A..,AA., AAA. seems unnecessary/redundant and should be removed.

Same issue/question for a,b,c vs. "a, aa, aaa"
Comment 1 Maxim Monastirsky 2023-03-17 08:12:22 UTC
The difference is from the 28th item. For "A, B, C" you get AB AC AD etc. while for "A.., AA.., AAA..." you get BB CC DD etc.
Comment 2 Stéphane Guillou (stragu) 2023-03-17 08:25:22 UTC
That also confused me in https://bugs.documentfoundation.org/show_bug.cgi?id=152985#c9

Let's make this a documentation issue, which should clarify the difference in:

https://help.libreoffice.org/latest/en-US/text/shared/01/06050500.html

Thanks!
Comment 3 sdc.blanco 2023-03-17 14:35:54 UTC
Updating also needed for:

https://help.libreoffice.org/latest/en-US/text/swriter/01/06060100.html
https://help.libreoffice.org/latest/en-US/text/swriter/01/06080100.html
https://help.libreoffice.org/latest/en-US/text/swriter/01/06080200.html

But how to describe?

Perhaps "A,B,C" must also be modified?

For example

--------
A,B,C,...  Alphabetical numbering with uppercase letters A-Z. After item 26, numbering continues AA, AB, AC...

A,AA,AAA,...  Alphabetical numbering with uppercase letters A-Z. After item 26, numbering continues AA, BB, CC...
----------------

This solution/proposal simply shows the difference between the two numbering schemes, but does not give an explicit general principle, like: A,B,C "numbering in modulo 26".  But I could not find short, comprehensible verbal explanations for the two schemes, hence the indexical solution. 

Can anyone help here?

The reason for specifying letters A-Z is that some alphabets have other letters, but they do not seem to be used (e.g., the numbering scheme does not include æ, å, ø from the Danish alphabet, when using Danish UI and locale).

Unless there are objections or a better proposal, I am inclined to use the text shown between the dashed lines.
Comment 4 sdc.blanco 2023-03-17 15:47:11 UTC
Created attachment 186033 [details]
screenshot of proposed updating

The attached shows how the help page [1] would appear, after the proposed changes.

For an alternative approach, see [2]. (I can understand the description there now, thanks to Maxim's essential clarifying comment).

The plan is to find one formulation, and embed it into the other pages, so that only one translation is required, and consistency can be maintained across the pages.


[1] https://help.libreoffice.org/latest/en-US/text/shared/01/06050500.html
[2] https://help.libreoffice.org/latest/en-US/text/swriter/01/06060100.html
Comment 5 Heiko Tietze 2023-03-17 15:51:10 UTC
"Single-Character Accumulation" vs. "Full-String Growth" or "Alphanumeric Steps" vs. "String Extensions".

Internally it is SVX_NUM_CHARS_UPPER_LETTER vs. SVX_NUM_CHARS_UPPER_LETTER_N

Skimming through the web it seems MSO has no ..Z,AA,AB... scheme and does always ..Z,AA,BB... We could name it therefore "Text Document-Style" vs. "Spreadsheet-Style".

The reason is to either keep it short or to make it easier to distinguish, could be useful for the documentation too.
Comment 6 sdc.blanco 2023-03-17 23:01:17 UTC
(In reply to Heiko Tietze from comment #5)

Thanks for interesting investigations.  Sympathetic with "keep it short", but unsure what change/addition you are proposing.

fwiw, from a documentation pov, there is no real need for labels, because I do not think other help pages refer to these numbering schemes.
Comment 7 Heiko Tietze 2023-03-20 07:37:14 UTC
(In reply to sdc.blanco from comment #6)
> ...unsure what change/addition you are proposing.

To resolve as NAB ;-)
Comment 8 sdc.blanco 2023-03-20 09:57:53 UTC
(In reply to Heiko Tietze from comment #7)
At the very least, there should be a consistent description across the different help pages, and clear documentation of the difference between the two numbering schemes. Here is a proposal, that corresponds to attachment 186033 [details]. 

https://gerrit.libreoffice.org/c/help/+/149028
Comment 9 Commit Notification 2023-03-26 17:10:13 UTC
Seth Chaiklin committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/help/commit/9c5ba9aeebcfb261ea59f2a43e489884c04a2e88

tdf#154234 clarify meaning of A,B,C (a,b,c) and A,AA,AAA (a,aa,aaa)