Bug 155012 - Same Help page used for Sign Document and Encrypt Document dialogs
Summary: Same Help page used for Sign Document and Encrypt Document dialogs
Status: NEW
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
7.6.0.0 alpha0+
Hardware: All All
: medium normal
Assignee: Dione Maddern
URL:
Whiteboard:
Keywords:
Depends on:
Blocks: Digital-Signatures Help-Changes-Features
  Show dependency treegraph
 
Reported: 2023-04-25 15:00 UTC by Stéphane Guillou (stragu)
Modified: 2024-04-05 22:01 UTC (History)
2 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 Stéphane Guillou (stragu) 2023-04-25 15:00:36 UTC
Two dialogs lead to the same Help page:

(1) File > Digital Signatures > Digital Signatures... > Sign Document... dialog: Help button leads to the "Select certificate" help page, with matching contents: https://help.libreoffice.org/7.6/en-US/text/shared/01/selectcertificate.html (HID=xmlsec/ui/selectcertificatedialog/grid1#bm_@@nowidget@@)
There are other ways to get to the Sign Document dialog, like with File > Export as PDF... > Digital Signatures tab > Select. 

(2) File > Save > Encrypt with GPG key > Save > "Select X.509 Certificate" dialog: Help button leads to the same page. Even though it is a similar dialog, there are differences:
   - The dialog talks about "Encryption", but the help page doesn't mention it. The page should link to other pages relevant to encryption, like https://help.libreoffice.org/7.6/en-US/text/shared/guide/openpgp.html;
   - No "Description" field in the dialog;
   [- There is no mention of X.509 certificates, which is in the dialog's title (although there might be something wrong there, given that PGP should be used by default for ODF - see bug 153626).]

I think there is enough difference to have a separate page for (2).

Tested with:

Version: 7.6.0.0.alpha0+ (X86_64) / LibreOffice Community
Build ID: 5cd9de202765e243e41416802f3e4486b8a96f16
CPU threads: 8; OS: Linux 5.15; UI render: default; VCL: gtk3
Locale: en-AU (en_AU.UTF-8); UI: en-US
Calc: threaded
Comment 1 Dione Maddern 2024-04-03 19:31:15 UTC
Someone correct me if I'm wrong, but I think in 24.8 at least, these are both the same dialog accessed through different paths. They both use the same HID and there is no mention of X.509. I'm getting:
1. File > Digital Signatures > Digital Signatures > Sign Document > Select Certificate
2 File > Save > Encrypt with GPG key > Save > Select Certificate

Tested with:
Version: 24.8.0.0.alpha0+ (X86_64) / LibreOffice Community
Build ID: 387a9c445793e8377f85e508d935dc070fd8ab74
CPU threads: 8; OS: Linux 6.8; UI render: default; VCL: x11
Locale: en-US (en_US.UTF-8); UI: en-US
Calc: threaded

Would adding 
- some additional information that the page more relevant to encryption, and 
- a link to the "Encrypting Documents with OpenPGP" page 
solve the problem?
Comment 2 Dione Maddern 2024-04-03 19:55:02 UTC
(In reply to Dione Maddern from comment #1)
> Someone correct me if I'm wrong, but I think in 24.8 at least, these are
> both the same dialog accessed through different paths. They both use the
> same HID and there is no mention of X.509. I'm getting:
> 1. File > Digital Signatures > Digital Signatures > Sign Document > Select
> Certificate
> 2 File > Save > Encrypt with GPG key > Save > Select Certificate
> 
> Tested with:
> Version: 24.8.0.0.alpha0+ (X86_64) / LibreOffice Community
> Build ID: 387a9c445793e8377f85e508d935dc070fd8ab74
> CPU threads: 8; OS: Linux 6.8; UI render: default; VCL: x11
> Locale: en-US (en_US.UTF-8); UI: en-US
> Calc: threaded
> 
> Would adding 
> - some additional information that the page more relevant to encryption, and 
> - a link to the "Encrypting Documents with OpenPGP" page 
> solve the problem?

Never mind. I'm blind. They are slightly.
Comment 3 Stéphane Guillou (stragu) 2024-04-04 02:11:58 UTC
Thanks for looking into it, Dione! For the X.509 title, this issue is relevant: bug 155049.
Comment 4 Dione Maddern 2024-04-05 22:01:35 UTC
Ah. I see. Thanks.

I think I should be able to get a separate page set up. Looks like the page could do with a little updating too.