Bug Hunting Session
Bug 112685 - LOCALHELP Document Advanced TSCP Classification dialog
Summary: LOCALHELP Document Advanced TSCP Classification dialog
Status: NEW
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
6.0.0.0.alpha0+
Hardware: All All
: medium normal
Assignee: Not Assigned
URL:
Whiteboard:
Keywords:
Depends on:
Blocks: HelpGaps-NewFeatures
  Show dependency treegraph
 
Reported: 2017-09-27 06:19 UTC by Gabor Kelemen
Modified: 2019-01-09 22:13 UTC (History)
4 users (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 Gabor Kelemen 2017-09-27 06:19:42 UTC
A new Advanced Classification dialog was recently added:

https://cgit.freedesktop.org/libreoffice/core/commit/?id=71ee09947d5a71105d64fd225bb3672dfa7ce834

Sounds like something needing a bit of explanation.

CC'ing Tomaz: do you have any clues for us to start with, like a blog post, about the functionality of this dialog?
Comment 1 Cor Nouws 2018-03-29 14:46:20 UTC
will provide some information. Hope the next week.
Comment 2 Cor Nouws 2019-01-04 18:08:57 UTC
(In reply to Cor Nouws from comment #1)
> will provide some information. Hope the next week.

:) :) :) :)
Comment 3 Tomaz Vajngerl 2019-01-04 20:39:56 UTC
You still have some time... :)
Comment 4 Cor Nouws 2019-01-04 22:18:02 UTC
(In reply to Tomaz Vajngerl from comment #3)
> You still have some time... :)
My most often used joke is "after the next week"...
 Q:"when will you be ready?" A: ..
 Me, complaining about being busy. But .. 

People with a bit mathematical thinking easily understand the joke; in 'normal' Dutch however, "after the next week" is in two weeks :)
... not for me ;)
Comment 5 Cor Nouws 2019-01-07 22:02:13 UTC
Current Help is this one
  https://help.libreoffice.org/6.2/en-US/text/swriter/classificationbar.html?

I've already drafted improvements and new info.
TODO
1 - make (part of the) Help for classification global - it is available in Writer, Calc and Impress
2 - distinct between the possibilities in Writer, Calc and Impress
3 - some bugs and minor enhancement

For reference there is documentation on extending, creating and translating Classification policy files:
  https://wiki.documentfoundation.org/TSCP-classification
Comment 6 Olivier Hallot 2019-01-09 22:13:28 UTC
(In reply to Cor Nouws from comment #5)
> Current Help is this one
>   https://help.libreoffice.org/6.2/en-US/text/swriter/classificationbar.html?
> 
> I've already drafted improvements and new info.
> TODO
> 1 - make (part of the) Help for classification global - it is available in
> Writer, Calc and Impress
> 2 - distinct between the possibilities in Writer, Calc and Impress
> 3 - some bugs and minor enhancement
> 
> For reference there is documentation on extending, creating and translating
> Classification policy files:
>   https://wiki.documentfoundation.org/TSCP-classification

Yes. The common contents can (optionally) stay in a separate file (wrapped in a <section>) and later <embed>'ed in the specific (Calc/Impress/Writer) classification help files.

If the contents is a user guide with instructions and steps to follow, then it should go to the /guide/ section of each module. If the contents gives details (references) of the classification commands and terminology, then think on placing it in folder /01/ of each module.

For example

scalc/01/classification-spreadsheet.xhp

swriter/01/classification-text.xhp

simpress/01/classification-presentation.xhp

shared/01/classification-common.xhp


so we may have 1 common, 3 references + 3 guides... 

Another approach, much less trivial is to use <switch select="appl"...> and have one file with all module switched, although I think it will be dense to maintain contents.