Update TLS/SSL documentation

RESOLVED WONTFIX

Status

P5
normal
RESOLVED WONTFIX
4 years ago
3 years ago

People

(Reporter: sheppy, Unassigned)

Tracking

Details

(URL)

(Reporter)

Description

4 years ago
:: Developer Documentation Request

      Request Type: Correction
     Gecko Version: unspecified
 Technical Contact: 

:: Details

We have various pages that discuss SSL, such as https://developer.mozilla.org/en-US/docs/Introduction_to_SSL, the NSS documentation, and then docs related to HTTPS. These pages need to be reviewed and updated as needed given that service workers will require TLS.

annevk also suggests that we may want to start referring to it as TLS (HTTPS). Covering TLS and HSTS at least would help be ready for service workers.
(Reporter)

Updated

4 years ago
Assignee: eshepherd → nobody
Blocks: 1050924
OpSec maintains TLS guidelines on wikimo: https://wiki.mozilla.org/Security/Server_Side_TLS
We usually store our docs on mana for internal pages, and wikimo for public pages.
What is the difference between wikimo and mdn for such pages? I don't have a preference as to where it should be published, as long as it is in a single location.
(Reporter)

Comment 3

4 years ago
MDN is where we document any developer documentation that's Web-facing. That should, IMO, include TLS. So this should migrate over.
(Reporter)

Comment 4

3 years ago
(In reply to Julien Vehent [:ulfr] {use needinfo} from comment #2)
> OpSec maintains TLS guidelines on wikimo:
> https://wiki.mozilla.org/Security/Server_Side_TLS
> We usually store our docs on mana for internal pages, and wikimo for public
> pages.
> What is the difference between wikimo and mdn for such pages? I don't have a
> preference as to where it should be published, as long as it is in a single
> location.

Any chance we can get some help moving those docs over to MDN? That's where we keep developer documentation for technologies that developers can take advantage of (where "developers" include Web devs, add-don devs, and Firefox devs).
Flags: needinfo?(jvehent)
My only issue is that the current location is very well-known. That page became one of the most referenced doc among sysadmins and security people to configure TLS servers. Moving it over to MDN will break the referencing, so at the moment I don't think it's worth moving it over to MDN.
Flags: needinfo?(jvehent)
Let's close this then. No point in migrating this.
Status: NEW → RESOLVED
Last Resolved: 3 years ago
Resolution: --- → WONTFIX
Summary: Update SSL documentation for service workers → Update TLS/SSL documentation

Comment 7

3 years ago
teoli, what about comment 0 is addressed though?
You need to log in before you can comment on or make changes to this bug.