Bug 143846 - Create separate help pages for each function in the "Text Functions" page
Summary: Create separate help pages for each function in the "Text Functions" page
Status: NEW
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
7.3.0.0 alpha0+
Hardware: All All
: medium normal
Assignee: Not Assigned
URL:
Whiteboard: target:7.3.0 target:25.2.0
Keywords:
Depends on:
Blocks: HelpGaps-NewFeatures
  Show dependency treegraph
 
Reported: 2021-08-12 18:54 UTC by Rafael Lima
Modified: 2024-11-02 16:48 UTC (History)
3 users (show)

See Also:
Crash report or crash signature:


Attachments
I've made a separate documentation for ARABIC function under TEXT. (12.03 KB, application/vnd.oasis.opendocument.text)
2021-09-02 17:09 UTC, Sanskar Goyal
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Rafael Lima 2021-08-12 18:54:26 UTC
Hi! The "Text Functions" help page (link below) is composed of multiple functions. Some of them have full descriptions in the help page [1] (some of them are short and some are long), whereas other functions have their own pages.

[1] https://help.libreoffice.org/7.3/en-US/text/scalc/01/04060110.html?DbPAR=CALC#bm_id3145389

This causes some imbalance in the "Text Functions" help page and in my opinion it looks a bit messy.

What I would like to propose is to create separate help pages for each function and keep the "Text Functions" help page with the names of functions followed by a short description, as it is currently done in some pages (e.g. the Tools page [2])

[2] https://help.libreoffice.org/7.3/en-US/text/swriter/main0106.html?&DbPAR=WRITER

This way, future update to the help files of each function will be more organized IMO.
Comment 1 Olivier Hallot 2021-08-12 20:51:54 UTC
Help maintainability is a good thing. I advise to proceed in a slow pace because this change will force retranslation of the concerned functions help contents.

The weblate tool used by LibreOffice community has translation memory to help the retranslation, however it the process is often dull.

I suggest to deliver one or 2 help file a month.
Comment 2 Rafael Lima 2021-08-12 22:36:37 UTC
Okay... I'll do it at a slow pace.
Comment 3 Sanskar Goyal 2021-09-02 17:09:28 UTC
Created attachment 174741 [details]
I've made a separate documentation for ARABIC function under TEXT.

I am contributing for the first time to LibreOffice. I have made a separate documentation for the ARABIC function to be used under Text category . I have added the syntax and examples as well.
Comment 4 Rafael Lima 2021-09-02 18:39:20 UTC
(In reply to Sanskar Goyal from comment #3)
> Created attachment 174741 [details]
> I've made a separate documentation for ARABIC function under TEXT.

Hi Sanskar, I'll consider your contribution when updating the ARABIC function.

Thanks!
Comment 5 Commit Notification 2021-10-21 18:02:16 UTC
Rafael Lima committed a patch related to this issue.
It has been pushed to "master":

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

Related tdf#143846 Improve Arabic/Roman help pages
Comment 6 Commit Notification 2021-11-24 22:17:43 UTC
Rafael Lima committed a patch related to this issue.
It has been pushed to "master":

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

tdf#143846 Separate help pages for ASC/JIS text functions
Comment 7 Xisco Faulí 2022-05-03 12:28:05 UTC
A polite ping to Rafael Lima:
Is this bug fixed? if so, could you please close it as RESOLVED FIXED ?
Otherwise, Could you please explain what's missing?
Thanks
Comment 8 Martin Srebotnjak 2022-11-23 19:54:28 UTC
Can we close this as RESOLVED FIXED?
Comment 9 Rafael Lima 2022-11-23 20:44:51 UTC
(In reply to Martin Srebotnjak from comment #8)
> Can we close this as RESOLVED FIXED?

Actually to fix this bug there's still some work to do. Some functions still have to be moved to their own files.

Right now I'm working on other issues, so I'll move this ticket back to NEW.

Later I might return to it, but not ATM.
Comment 10 fpy 2024-09-01 19:19:45 UTC
(In reply to Martin Srebotnjak from comment #8)
> Can we close this as RESOLVED FIXED?

9 done,
31 remaining,

(In reply to Olivier Hallot from comment #1)
> I suggest to deliver one or 2 help file a month.


could be closed early 2026.

1 bahttext
2 base
3 char
4 clean
5 code
6 concatenate
7 decimal
8 dollar
9 exact
10 find
11 fixed
12 left
13 leftb
14 len
15 lenb
16 lower
17 mid
18 midb
19 proper
20 replace
21 rept
22 right
23 rightb
24 search
25 substitute
26 t
27 text
28 trim
29 unichar
30 unicode
31 upper
Comment 11 Commit Notification 2024-10-04 16:21:29 UTC
Pierre F committed a patch related to this issue.
It has been pushed to "master":

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

tdf#143846 split BASE + BAHTTEXT
Comment 12 Commit Notification 2024-10-24 12:02:13 UTC
Pierre F committed a patch related to this issue.
It has been pushed to "master":

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

tdf#143846 split CHAR + CLEAN. + helper
Comment 13 Commit Notification 2024-10-29 11:17:12 UTC
Pierre F committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/help/commit/7b7ddc4bf507d27578f3bf17fd28dc40b95d6586

tdf#143846 split CODE() + CONCATENATE()
Comment 14 Commit Notification 2024-10-30 11:59:11 UTC
Pierre F committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/help/commit/8493c54bdde03bdc793b83402b9c341a5a97efac

tdf#143846 split DECIMAL() + DOLLAR()
Comment 15 Commit Notification 2024-11-01 13:44:16 UTC
Pierre F committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/help/commit/1fd4ec9539b4403f5a87ab42da93fe2f05a5388b

tdf#143846 split EXACT FIND FIXED LEFT LEN LOWER
Comment 16 Commit Notification 2024-11-02 16:48:42 UTC
Pierre F committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/help/commit/3b6506e4e1b6b4dd41f4e5e8fda8315426c57d9c

tdf#143846 split PROPER REPLACE REPT RIGHT SEARCH ...