Bug 153850 - Replace vague or undefined terms with specific dates and/or versions
Summary: Replace vague or undefined terms with specific dates and/or versions
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:
Keywords:
Depends on:
Blocks:
 
Reported: 2023-02-27 10:01 UTC by ady
Modified: 2023-02-27 10:24 UTC (History)
1 user (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 ady 2023-02-27 10:01:55 UTC
At the end of:

https://help.libreoffice.org/latest/en-US/text/scalc/01/04060199.html?DbPAR=CALC#hd_id3153550

there is currently a note:
  -- Start quote --
Reference concatenation using a tilde character was implemented lately. When a formula with the tilde operator exists in a document that is opened in old versions of the software, an error is returned. A reference list is not allowed inside an array expression.
  -- End quote --

First, the very last sentence seems unrelated to the rest, and should rather be located in its own paragraph, even if it all resides within the same "note box".

Additionally, the terminology should not be so vague / undefined. Instead of "lately", there should be a specific version in which the feature is to be considered stable and fully implemented (and valid / supported since then).

Similarly, the use of "old versions of the software" is too vague.

Generally speaking, the references and expressions should point to either:
* a date and/or
* a LO version and/or
* a standard (e.g. ODF, XML) version.

If possible (and relevant) a combination of the above should be provided; for instance a LO version, released at a certain date, and (an extension to) the ODF standard version where the feature is valid / invalid.

There might be other similarly vague / undefined references in the help files, and/or the official Manuals / User Guides.

A simple example of a better terminology is at:
https://help.libreoffice.org/latest/en-US/text/scalc/01/04060105.html?DbPAR=CALC#bm_id3156257

regarding the XOR function:

"This function is available since LibreOffice 4.0.".
Comment 1 Mike Kaganski 2023-02-27 10:24:27 UTC
Fixed by https://gerrit.libreoffice.org/c/help/+/144825