1623857 - Create Thunderbird KB article: Learn more about e2e-encryption

Status: RESOLVED WORKSFORME

(MailNews Core :: Security: OpenPGP, task, P1)

Description

[Kai Engert [:KaiE:]]

In bug 1603809 we added a "learn more" hyperlink to the preferences for end-to-end encryption.

We need to create an article in the knowledgebase that will be opened by that link.

(Right now it's a dead link.)

Comment 1

[Magnus Melin [:mkmelin]]

Currently pointing to https://support.mozilla.org/en-US/kb/introduction-to-e2e-encryption

Comment 2

[Ryan Lee Sipes]

I can start the page for it, do we have any place I can grab the content for an article from? Or do I need to write it from scratch?

Comment 3

[Kai Engert [:KaiE:]]

We must create new content, that explains it according to the implementation choices we have made.
I had intended to work on that a bit later, once we are done with most of the critical coding work, like after 78.1

Comment 4

[Kai Engert [:KaiE:]]

If someone could help to create the initial placeholder article with the correct URL, and point me to the workflow for updating KB articles, that would help!

Comment 5

[Kai Engert [:KaiE:]]

Attachment: thunderbird-e2ee-encryption-knowledgebase-kb-article.txt

Comment 6

[Wayne Mery (:wsmwk)]

You might be able to copy https://support.mozilla.org/en-US/kb/digitally-signing-and-encrypting-messages and use it as a starting template, then plug in text from comment 5.

Comment 7

[Wayne Mery (:wsmwk)]

This article should also point to https://thunderbird.topicbox.com/groups/e2ee for user discussion and support

Comment 8

[Ryan Lee Sipes]

First go in review (with the addition of the group for support). We should definitely update the original digitally-signing-and encrypted-messages article and link to it or combine the two.

Wayne, could you review the current iteration? https://support.mozilla.org/en-US/kb/introduction-to-e2e-encryption/history#preview

Comment 9

[Wayne Mery (:wsmwk)]

The article is essentially complete - just a few more edits.

Comment 10

[Magnus Melin [:mkmelin]]

Pretty long article, I did some smaller edits now. It might be worth adding a TL;DR version on top, with like 5 bullet points.
What's also slightly missing is description of what the practical problems are: you can't read encrypted emails on your phone too easily.

Comment 11

[Wayne Mery (:wsmwk)]

(In reply to Magnus Melin [:mkmelin] from comment #10)

Pretty long article, I did some smaller edits now.

Nice changes, and I see you have incorporated most or all of Marco's findings.

1. It might be worth adding a TL;DR version on top, with like 5 bullet points.
2. What's also slightly missing is description of what the practical problems are: you can't read encrypted emails on your phone too easily.

Jon or Andreas, care to take a crack one or both of these last two items? (or someone else)

Post the text here in the bug or do https://support.mozilla.org/en-US/kb/introduction-to-e2e-encryption/history, click the most recent revision, then "Edit article based on this revision".

Comment 12

[Jon]

A few people flagged this but hadn't submitted a bug as yet; will pass it to them to help with the content!