Bug 80430 (HelpGaps-NewFeatures)

Summary: [META] Documentation gap for new features
Product: LibreOffice Reporter: Olivier Hallot <olivier.hallot>
Component: DocumentationAssignee: Not Assigned <libreoffice-bugs>
Status: NEW ---    
Severity: normal CC: barta, beimaginativeegroup, cno, cpgeevan, marina.latini, philipz85, rb.henschel, sophia.schroeder, thomas.lendo, vsfoote
Priority: medium    
Version: unspecified   
Hardware: Other   
OS: All   
See Also: https://bugs.documentfoundation.org/show_bug.cgi?id=93580
https://bugs.documentfoundation.org/show_bug.cgi?id=105581
https://bugs.documentfoundation.org/show_bug.cgi?id=120200
https://bugs.documentfoundation.org/show_bug.cgi?id=92825
https://bugs.documentfoundation.org/show_bug.cgi?id=120201
Whiteboard:
Crash report or crash signature: Regression By:
Bug Depends on: 94620, 98986, 129978, 131235, 132308, 132784, 137292, 140811, 143183, 143504, 143754, 143846, 146902, 148902, 149091, 149211, 149220, 149223, 149224, 152161, 153583, 153732, 154188, 154996, 156081, 156715, 159804, 159872, 160057, 160641, 160909, 161091, 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, 119269, 119657, 120612, 120752, 120927, 121065, 121084, 121613, 121735, 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, 135668, 135686, 135688, 135837, 136213, 136435, 136510, 136939, 137259, 137347, 137649, 137680, 138301, 138627, 139027, 139286, 139436, 139469, 139542, 139543, 139616, 140000, 140068, 140096, 140118, 140446, 140553, 140779, 140780, 140781, 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, 149218, 149221, 149222, 149352, 149393, 149455, 149607, 149846, 150445, 151169, 151386, 152016, 152296, 152323, 152397, 152499, 152589, 152910, 153108, 153122, 153204, 153574, 153986, 154121, 154132, 154335, 154364, 154475, 154687, 155031, 155100, 155234, 155882, 156273, 156441, 156581, 156605, 157822, 159596, 159725, 159771, 159830, 160179    
Bug Blocks: 106040, 146733    
Attachments: Analysis about help of 4.0 features

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.