Bug 80430 (HelpGaps-NewFeatures) - [META] Documentation gap for new features
Summary: [META] Documentation gap for new features
Status: NEW
Alias: HelpGaps-NewFeatures
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
unspecified
Hardware: Other All
: medium normal
Assignee: Not Assigned
URL:
Whiteboard:
Keywords:
Depends on: 94620 98986 118589 129978 131235 132308 132784 137292 137680 143183 143504 143754 143846 146902 148902 149211 149223 149224 153583 154188 154996 156081 156715 159804 160641 162244 162275 162296 162416 162607 163714 163745 36970 38781 40460 42282 52986 55212 59698 60858 64773 65991 68871 70141 72038 76535 80338 80367 80431 80432 80433 80435 80436 80438 80439 80440 80441 80442 80443 80444 80445 80446 80447 80449 80450 80451 80452 80453 80481 80586 80588 80589 80590 80652 80656 80658 81599 83160 83269 83283 83289 84346 84371 84455 84675 85228 85433 85686 85773 86521 86522 86525 86637 86866 89419 89453 90369 90371 91313 91817 91992 92009 92068 92069 92070 92084 92183 92302 92430 92819 92837 93299 94020 94202 94438 94454 94537 95093 95281 95282 95490 95496 95501 96042 96868 97021 97366 97683 97818 97823 97824 97831 98054 98608 98717 98870 98910 99483 99517 99611 99637 99809 100096 100353 100355 100410 100586 100796 100810 100928 101034 101140 101235 101442 102151 102259 102517 102930 103241 103397 103431 103457 103587 104404 105004 105122 105562 105606 106421 106623 106861 106875 106957 107040 107076 107077 107079 107229 107758 108335 108674 108675 108676 108677 108678 108679 108680 111083 111413 111434 111435 111651 111777 111988 112003 112155 112221 112356 112685 113240 113242 113249 113804 113847 113949 114240 114263 114418 114930 114995 115440 115599 115797 115905 116381 116642 116751 116909 116927 117239 117463 117745 117933 118115 118473 118538 118588 119269 119657 120612 120752 120927 121065 121084 121613 Help-python-scripts 121736 122631 122706 122840 122842 123192 123803 124105 124204 124205 124299 124502 124606 125867 126492 126507 126720 127385 127716 128252 128589 128590 129069 129169 129171 129209 129239 129292 129497 129918 130063 130212 130619 130620 130654 131357 131362 131403 131416 131825 131995 132227 132325 132390 132440 132464 132465 132534 132586 132720 132858 132906 133109 133116 133156 133846 135298 Help_for_Navigator 135686 135688 135837 136213 136435 136510 136939 137259 137347 137649 138301 138627 139027 139286 139436 139469 139542 139543 139616 140000 140068 140096 140118 140446 140553 140779 140780 140781 140811 140890 141095 141179 141237 141316 141818 141822 141929 142417 142574 142652 143232 143319 144055 144332 144339 144444 144957 145067 145617 145898 146336 146580 146847 147011 147105 147134 147136 147137 147362 147977 148485 148817 149086 149091 149218 149220 149221 149222 149352 149393 149455 149607 149846 150445 151169 151386 152016 152161 152296 152323 152397 152499 152589 152910 153108 153122 153204 153574 153732 153986 154121 154132 154335 154364 154475 154687 155031 155100 155234 155882 156273 156441 156581 156605 157822 159596 159725 159771 159830 159872 160057 160179 160909 161091 161400 161401 161402 161442 161579 161638 161639 161883 162001 162273 162847 162905 163053
Blocks: Help 146733
  Show dependency treegraph
 
Reported: 2014-06-24 00:00 UTC by Olivier Hallot
Modified: 2024-11-04 12:08 UTC (History)
10 users (show)

See Also:
Crash report or crash signature:


Attachments
Analysis about help of 4.0 features (27.22 KB, application/vnd.oasis.opendocument.spreadsheet)
2014-06-24 22:10 UTC, m_a_riosv
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Olivier Hallot 2014-06-24 00:00:45 UTC
This is a meta issue to track the bugs and tasks of documenting new features introduced in LibreOffice that has no User Guide or References written in the LOCALHELP.

Just open a bug indicating the missing help pages and add it as a dependency of this one.
Comment 1 Olivier Hallot 2014-06-24 00:24:39 UTC
Added bugs for Calc

XML Source

Data Statistics (ANOVA, etc...)
Comment 2 m_a_riosv 2014-06-24 22:10:27 UTC
Created attachment 101702 [details]
Analysis about help of 4.0 features

Hi Olivier, thanks for bring this matter into the community attention.

More than a year ago I posted in QA list about this issue, without any success, about 4.0 features. (http://nabble.documentfoundation.org/LibreOffice-help-update-tc4048388.html#a4048685).

I think an appropriate help does more brilliant, visible and usable developer's work, and also easier the life for the user and the people trying to help users in Ask, ML, etc. An everybody wins.
Comment 3 Olivier Hallot 2014-06-27 09:49:05 UTC
(In reply to comment #2)
> Created attachment 101702 [details]
> Analysis about help of 4.0 features
> 
> Hi Olivier, thanks for bring this matter into the community attention.
> 
> More than a year ago I posted in QA list about this issue, without any
> success, about 4.0 features.
> (http://nabble.documentfoundation.org/LibreOffice-help-update-tc4048388.
> html#a4048685).
> 
> I think an appropriate help does more brilliant, visible and usable
> developer's work, and also easier the life for the user and the people
> trying to help users in Ask, ML, etc. An everybody wins.

Thanks for the spreadsheet. It will be nice to open a bug for each issue reported and link to this metabug.
Comment 4 Marina Latini (SUSE) 2014-06-27 10:30:15 UTC
Added bug 80586 LOCALHELP: write help page for Tools - Options- LibreOffice - Personalizations
Comment 5 Marina Latini (SUSE) 2014-06-27 10:53:04 UTC
Added bug 80588 LOCALHELP: write help page for Tools - Options- LibreOffice - Basic IDE Options
Comment 6 Marina Latini (SUSE) 2014-06-27 11:02:32 UTC
Added bug 80589 LOCALHELP: write help page for Tools - Options - LibreOffice - Advanced - Expert Configuration
Comment 7 Olivier Hallot 2014-06-27 11:06:36 UTC
Added bug 80590, help pages for Writer, Format - Title page ...
Comment 8 Olivier Hallot 2014-06-28 22:18:12 UTC
added bug 80652, write help entries for file services thru CMIS/WEBDAV, etc...
Comment 9 Olivier Hallot 2014-06-28 22:58:21 UTC
added bug 80656

Write help page for NUMBERVALUE calc function as in ODFF 1.2
Comment 10 Olivier Hallot 2014-06-28 23:24:17 UTC
Added bug 80658

write help page for Calc Stream

Menu Data - Streams
Comment 11 Olivier Hallot 2014-07-21 12:49:05 UTC
added bug81599: write better Calc Solver user guide, with references to the solver engines implemented (esp. in LO 4.3)
Comment 12 Olivier Hallot 2014-08-27 19:06:40 UTC
Added bug 83160 

Write help pages for Impress Remote
Comment 13 Olivier Hallot 2014-08-30 11:52:57 UTC
added bug83269: write help page for Calc - Dat - Form...
Comment 14 Olivier Hallot 2014-08-30 19:28:09 UTC
add bug83283

Help page and help button for Label field selection
Comment 15 Olivier Hallot 2014-10-20 10:25:09 UTC
added bug 85228

Write Help entry for AGGREGATE Calc function
Comment 16 Olivier Hallot 2014-10-31 07:46:01 UTC
Added bug 85686 for Recalculation on File Load in Calc - Options - Formula
Comment 17 Yousuf Philips (jay) (retired) 2014-11-04 15:06:36 UTC
Hi Ohallot,

Samuel, Adolfo and I have been keeping track of visible string changes in this wiki page < https://wiki.documentfoundation.org/Documentation/RecentStringChanges > and Sophie said to add it here.
Comment 18 Olivier Hallot 2014-11-04 16:25:46 UTC
Thanks for adding it here. The idea is to open a bug (AKA task) to update helpcontent2 when the UI changes. That bug is very likely an EasyHack to be fixed by the community.
Comment 19 tommy27 2014-11-30 09:38:22 UTC
added Bug 86866 - In Help, describe AutoCorrect Options Replace "Ok, Cancel, Reset" buttons
Comment 20 Marina Latini (SUSE) 2015-03-31 12:41:29 UTC
added bug 90369 - LOCALHELP: write help page for Tools - Options - LibreOffice - General - Help Improve LibreOfficeDev
Comment 21 Marina Latini (SUSE) 2015-03-31 12:52:25 UTC
added Bug 90371 - LOCALHELP: write help page for Tools - Options - LibreOffice - Load/Save - Microsoft Office - Character Background
Comment 22 Olivier Hallot 2015-05-04 09:47:44 UTC
added Bug 68871 - Remove the old Elements panel (View → Elements) from Math
Comment 23 V Stuart Foote 2015-08-14 11:48:11 UTC
added bug 60858 -- Menu doesn't list anything for horizontal line

Built-in help and Wiki need correction
Comment 24 V Stuart Foote 2015-08-14 12:16:36 UTC
(In reply to V Stuart Foote from comment #23)
> added bug 60858 -- Menu doesn't list anything for horizontal line
> 
> Built-in help and Wiki need correction

Actually already pretty well cleared out of built-in help, found just http://opengrok.libreoffice.org/xref/help/source/text/swriter/00/00000404.xhp#304

but Wiki help has a fair amount left:

https://help.libreoffice.org/Writer/Inserting_a_Horizontal_Line
https://help.libreoffice.org/Writer/Insert_Horizontal_Rule

and translations.
Comment 25 Yousuf Philips (jay) (retired) 2015-09-03 05:07:22 UTC
Bug 92825 - Updating the help to correspond to the menu changes in bug 91781, bug 91820, and bug 91857.
Comment 26 Marina Latini (SUSE) 2015-10-12 10:57:41 UTC
Added bug 52986 - LOCALHELP: WRITER Mail Merge Wizard: Editor Help Button leads to unspecific help
Comment 27 tagezi 2015-10-23 13:28:48 UTC
Added Bug 95262 - Mistake in Help instructions for editing Comments
Comment 28 tagezi 2015-10-23 15:47:58 UTC
Bug 92069 - LOCALHELP: write help page for Calc ENCODEURL function
Comment 29 tagezi 2015-10-23 15:50:19 UTC
Bug 80439 - LOCALHELP: write help page for NETWORKDAYS.INTL and WORKDAY.INTL spreadsheet functions
Comment 30 tagezi 2015-10-23 21:17:00 UTC
Added Bug 95281 - [LOCALHELP]: write help page for SKEWP spreadsheet functions
Comment 31 tagezi 2015-10-23 21:19:57 UTC
Added Bug 95282 - [LOCALHELP]: write help page for COLOR spreadsheet functions
Comment 32 tagezi 2015-10-23 21:30:55 UTC
added Bug 92084 - LOCALHELP: Write help pages for CALC functions OPT_*

https://en.wikipedia.org/wiki/Black%E2%80%93Scholes_model
Comment 33 Cor Nouws 2016-10-04 11:13:02 UTC
adding Bug 92837 - Documentation doesn't explain why opening a ODS file asks to update external links even if in the options is marked as 'always update' - hint in comment #33
Comment 34 V Stuart Foote 2017-05-10 19:11:13 UTC
Added bug 107758 to add documentation on using Customize of Context Menu new feature.
Comment 35 Buovjaga 2018-09-29 14:50:20 UTC
The meaning of this meta bug was diluted over the years. I removed many reports that do not deal with new features needing documentation.

Everyone: remember that meta bugs should provide some additional value. The component "Documentation" already tells us that there is *some need* concerning Help. If we throw absolutely everything under "HelpGaps" it becomes meaningless.

I have changed the alias to be more precise and hopefully avoid sprawl.

In this sense, I also question the usefulness of "Bug 106040 (Help) - [META] Help bugs and enhancements". I get it that it might be aimed to be a "meta bug for meta bugs", but the name really does not describe this. People have already thrown random bugs into it.
Comment 36 Thomas Lendo 2018-09-29 16:38:05 UTC
(In reply to Buovjaga from comment #35)
Meta bugs should provide an overview of bugs of a specific topic in a way that other existing ways can't provide. Therefore a meta meta bug collects all meta bugs of this topic as well as other single bugs that don't fit into a (sub) meta.

For me, this meta isn't only for missing help about new features but missing help or partial missing help info for EVERY feature in LibreOffice.
Comment 37 Buovjaga 2018-09-29 16:50:47 UTC
(In reply to Thomas Lendo from comment #36)
> (In reply to Buovjaga from comment #35)
> Meta bugs should provide an overview of bugs of a specific topic in a way
> that other existing ways can't provide. Therefore a meta meta bug collects
> all meta bugs of this topic as well as other single bugs that don't fit into
> a (sub) meta.
> 
> For me, this meta isn't only for missing help about new features but missing
> help or partial missing help info for EVERY feature in LibreOffice.

What you describe is the component "Documentation" - by default I would expect reports against it to be about missing stuff in help. Meta bugs need to be about something more fine-grained. Let's keep this for the original purpose outlined in comment 0.

No removed features.
No stuff about changes to existing features.
No menu changes.
etc.
Comment 38 Thomas Lendo 2018-09-29 18:19:42 UTC
Alright, I'll see if bugs don't fit into this meta anymore. I'll adapt the summary and alias accordingly.