This forum is a discussion about improving the "How do I tell if my connection to a website is secure?" article. If you'd like to participate, please register.

If you need help with Firefox, please ask a question.

[Attn: Admin - Joni] Complexity level of this article's contents

  • 2 Replies
  • Last reply by AliceWyman
  1. vesper 1127 posts
    Report Abuse

    I was pinged by one of our localizers and decided to get a response from the KB editors regarding the style and complexity level of this article, since there seem to be two competing views, resulting in frequent changes to the way the article explains the security features.

    Some edits make this article very accurate and rather technical, possibly harder for the mythical "average reader". Other edits simplify it to make it more accessible, at the cost of technical accuracy.

    One could say it's ultimately up to Joni to decide what it should sound like, but since everyone creates the KB equally, what is your take on it?

    I was pinged by one of our localizers and decided to get a response from the KB editors regarding the style and complexity level of this article, since there seem to be two competing views, resulting in frequent changes to the way the article explains the security features. Some edits make this article very accurate and rather technical, possibly harder for the mythical "average reader". Other edits simplify it to make it more accessible, at the cost of technical accuracy. One could say it's ultimately up to Joni to decide what it should sound like, but since everyone creates the KB equally, what is your take on it?
  2. AliceWyman 4911 posts
    Report Abuse

    vesper said

    I was pinged by one of our localizers and decided to get a response from the KB editors regarding the style and complexity level of this article, since there seem to be two competing views, resulting in frequent changes to the way the article explains the security features. Some edits make this article very accurate and rather technical, possibly harder for the mythical "average reader". Other edits simplify it to make it more accessible, at the cost of technical accuracy. One could say it's ultimately up to Joni to decide what it should sound like, but since everyone creates the KB equally, what is your take on it?

    The History of this article shows that recent changes were either written or approved by Joni. I added [Attn: Admin - Joni] to the thread title.

    There will always be competing views on how articles should be written. I think we should try to balance simplicity with technical accuracy. I think the complexity level of this article is about right for the subject matter ... except the the word encrypted appears multiple times and could use a reference (we could link to https://en.wikipedia.org/wiki/Encryption for a definition).

    In his comment for the Nov 17, 2015 edit, gerv - Gervase Markham: https://mozillians.org/en-US/u/gerv/ - wrote, Update to fix some errors and simplify and clarify the text (I help run Mozilla's certificate program). That edit was approved by Joni. I just approved follow-up edits by Artist and Tonnes but those didn't change the way the article explains security features.

    ''vesper [[#post-12848|said]]'' <blockquote> I was pinged by one of our localizers and decided to get a response from the KB editors regarding the style and complexity level of this article, since there seem to be two competing views, resulting in frequent changes to the way the article explains the security features. Some edits make this article very accurate and rather technical, possibly harder for the mythical "average reader". Other edits simplify it to make it more accessible, at the cost of technical accuracy. One could say it's ultimately up to Joni to decide what it should sound like, but since everyone creates the KB equally, what is your take on it? </blockquote> The [https://support.mozilla.org/en-US/kb/how-do-i-tell-if-my-connection-is-secure/history History] of this article shows that recent changes were either written or approved by Joni. I added [Attn: Admin - Joni] to the thread title. There will always be competing views on how articles should be written. I think we should try to balance simplicity with technical accuracy. I think the complexity level of this article is about right for the subject matter ... except the the word '''encrypted''' appears multiple times and could use a reference (we could link to https://en.wikipedia.org/wiki/Encryption for a definition). In his comment for the Nov 17, 2015 edit, gerv - Gervase Markham: https://mozillians.org/en-US/u/gerv/ - wrote, ''Update to fix some errors and simplify and clarify the text (I help run Mozilla's certificate program)''. That edit was approved by Joni. I just approved follow-up edits by Artist and Tonnes but those didn't change the way the article explains security features.
  3. AliceWyman 4911 posts
    Report Abuse

    To Joni and vesper, see also this thread started by Kim Ludvigsen on November 28, 2015 9:13:50 PM EST:

    https://support.mozilla.org/en-US/kb/how-do-i-tell-if-my-connection-is-secure/discuss/6399 Scaring people with wrong information (Gray globe)

    This is about a change made to this article for fx42 in the Nov 17, 2015 revision approved by Joni. I have an edit pending review based on the suggestion made in that thread.

    To Joni and vesper, see also this thread started by [/user/KimLudvigsen Kim Ludvigsen] on November 28, 2015 9:13:50 PM EST: https://support.mozilla.org/en-US/kb/how-do-i-tell-if-my-connection-is-secure/discuss/6399 ''Scaring people with wrong information (Gray globe)'' This is about a change made to this article for fx42 in [https://support.mozilla.org/en-US/kb/how-do-i-tell-if-my-connection-is-secure/revision/109362 the Nov 17, 2015 revision] approved by Joni. I have an edit pending review based on the suggestion made in that thread.