History of Writing guide for Knowledge Base articles Category: How to contribute Revision history for: English Show Helpfulness Votes Chart Compare Selected Revisions Revision Status S Editor R Comment Apr 9, 2024, 12:00:46 PM Unreviewed Abby update for upcoming style guide changes Mar 22, 2024, 10:46:04 AM Current AliceWyman updated link to renamed article Mar 3, 2024, 2:48:45 AM Approved M AliceWyman Article categories, other small edits Feb 29, 2024, 7:17:14 AM Approved MT Kiki adding conjunction and disclaimer, plus styling an example text with blockquote Feb 29, 2024, 6:40:45 AM Approved M Lucas Siebert Added guidelines on how to link to external documentation for third-party software Dec 14, 2023, 7:10:36 AM Approved M AliceWyman http->https; fixed capitalization error for "Editorial guidelines for Mozilla accounts" (bug 1867499) Nov 19, 2023, 1:32:33 AM Approved M AliceWyman Slug: small edits to pending revision Nov 6, 2023, 6:48:36 PM Unreviewed AliceWyman Search summary, Slug: minor edits Oct 29, 2023, 3:59:40 PM Approved M AliceWyman Slug, Fix the slug: updated for existing articles Oct 29, 2023, 3:40:53 PM Unreviewed AliceWyman Technical guidelines: added link for editing an existing article Oct 10, 2023, 5:27:08 AM Approved M Mozinet corrections and minor edits, and added a sample macOS keyboard shortcut Oct 10, 2023, 12:15:54 AM Approved Lucas Siebert Minor markup fix Oct 9, 2023, 11:54:21 PM Approved M Lucas Siebert Approved by the Content Manager on Oct 4th/23 Feb 16, 2023, 6:40:24 AM Approved AliceWyman small edits to last revision Jan 9, 2022, 9:27:52 AM Unreviewed JeremyKoozar Restructured first sentence under “Writing style” > “Images and video”; Capitalized first words in bulleted list/restructured some sentences under “Readability”; Restructured first sentence under “Write a good search summary". Dec 30, 2021, 6:11:08 PM Approved M AliceWyman Intro: added en-US to link for "this article's Discussion forum" Dec 30, 2021, 10:19:48 AM Approved JeremyKoozar The examples listed below are initialisms not acronyms, updated to reflect this. Sep 17, 2021, 5:12:37 AM Unreviewed Jessica Raymond Https not working proper Sep 1, 2021, 1:51:10 AM Approved M AliceWyman Intro: updated link to this article's Discussion forum Sep 1, 2021, 12:46:30 AM Approved AliceWyman Title: avoid using "-ing" task names Aug 31, 2021, 2:17:13 AM Approved AliceWyman Title: removed "and avoid using "-ing" words." Apr 29, 2021, 9:38:19 PM Approved M AliceWyman removed link to https://www.mozilla.org/en-US/styleguide/communications/copy-rules/ (no more Mozilla Style Guide) Apr 28, 2021, 7:21:35 AM Approved M John E Case Added the word "you" to a sentence under Keep it short, changed to links to https. Mar 22, 2021, 7:18:40 AM Approved M Fabi Updated to follow Mozilla's technical guidelines Mar 22, 2021, 7:12:03 AM Unreviewed Fabi Updated to follow Mozilla's technical guidelines Mar 17, 2021, 7:49:16 AM Unreviewed Fabi Technical guidelines and Style guide updated Feb 16, 2021, 2:45:39 AM Approved M Chris Ilias reverting to r200498 - rules changes shouldn't be approved without Joni's approval Feb 16, 2021, 12:18:02 AM Reviewed M Fabi Oxford comma Feb 15, 2021, 11:50:35 PM Unreviewed Fabi Oxford comma Oct 7, 2020, 6:05:29 AM Approved M Erin S. Fixed grammatical errors and reworded sentences for a better flow. May 17, 2020, 2:34:09 AM Approved M AliceWyman "Readability" moved above Technical Guidelines, changed heading to level-2, May 15, 2020, 12:50:27 AM Approved Steven Fixed bulletpoints which displayed incorrectly. May 8, 2020, 7:27:44 PM Approved M AliceWyman "Images and video" reworded May 8, 2020, 4:01:23 AM Approved Angela Lazar fix typo May 8, 2020, 3:59:51 AM Approved M Angela Lazar Add about avoiding slang and idioms Feb 28, 2020, 9:25:15 PM Approved M Stacy add a readability tips Feb 27, 2020, 9:23:35 PM Reviewed M Stacy Adding some examples Feb 26, 2020, 7:17:32 PM Approved AliceWyman Title: 65 characters Feb 26, 2020, 5:02:13 PM Unreviewed gleb-urencev Updated the information. Some new features for text writing added. Pictures for titles examples added. May 7, 2018, 8:06:50 PM Approved M AliceWyman Style guide and copy rules: log in (same applies to sign in) Jul 11, 2016, 6:43:25 AM Approved M AliceWyman reworked Writing style sections Jul 11, 2016, 6:16:39 AM Approved M AliceWyman fixed internal link to #w_style-guide-and-copy-rules Jul 9, 2016, 10:40:06 PM Approved M AliceWyman resubmitted last revision, with edits (see discussion) Jul 9, 2016, 12:36:18 AM Reviewed M AliceWyman Language -> Style guide and copy rules; website vs web page, other edits Jun 27, 2016, 11:17:47 AM Approved M Joni version 1. This will evolve this quarter as the creative team helps us with more direction Mar 12, 2016, 10:20:40 PM Approved M AliceWyman Capitalization: added brand, product and feature names per https://www.mozilla.org/en-US/styleguide/communications/copy-rules/ Mar 12, 2016, 9:46:30 PM Approved M AliceWyman Capitalization: added wikipedia link for proper nouns and names. Removed outdated hidden comment on short links Mar 12, 2016, 7:16:56 AM Approved M AliceWyman Intro: updated link to renamed article and other edits Mar 7, 2016, 2:01:57 AM Approved M AliceWyman Use sentence-style capitalization in section headings as well as titles. Removed excess "fluff", other edits Mar 2, 2016, 11:04:29 AM Reviewed M Laucon I added a google form. Mar 2, 2016, 12:19:08 AM Reviewed M Laucon I took out the header because it was the same as the title Mar 1, 2016, 11:47:18 PM Reviewed M Laucon I added one link. Feb 16, 2016, 2:28:48 AM Reviewed M Laucon I added a video Feb 10, 2016, 11:17:22 AM Reviewed M Artist minor rewording Feb 10, 2016, 7:34:16 AM Reviewed M Laucon I changed the title Feb 8, 2016, 2:26:15 AM Reviewed M Laucon I edited links. Feb 8, 2016, 12:03:22 AM Reviewed M Laucon I completely changed this article. Jan 26, 2016, 7:25:44 PM Approved M AliceWyman expanded search summary, linked to related articles Aug 18, 2015, 10:19:00 PM Approved AliceWyman fixed typo Aug 18, 2015, 10:08:40 PM Approved AliceWyman minor edit to last revision Aug 18, 2015, 9:55:04 PM Approved M AliceWyman SUMO style guide: serial commas, Mozilla Style Guide link, other edits Jun 15, 2015, 10:22:18 AM Approved M AliceWyman Search summary note (see discussion) Jun 15, 2015, 8:54:49 AM Approved M Joni search summary: 160 to 140 Mar 11, 2015, 9:25:13 AM Approved M Joni removed guideline re: omitting product names Mar 10, 2015, 3:10:51 AM Approved M Joni added note about including product names in the title Dec 12, 2014, 8:30:24 PM Approved M AliceWyman Edit to last revision: added Capitalization under Pick a good title (see discussion) Dec 10, 2014, 7:38:35 PM Unreviewed AliceWyman updates to last revision - see discussion Dec 9, 2014, 3:39:38 PM Unreviewed Artist word and syntax edits, see new discussion Nov 25, 2014, 8:30:16 PM Approved M AliceWyman edit to last revision" removed "between words" Nov 25, 2014, 8:06:56 PM Approved M AliceWyman Pick a good title: Don't have extra spaces between words (see discussion) Oct 24, 2014, 4:24:52 AM Approved M AliceWyman minor edit to last revision Sep 23, 2014, 5:45:12 AM Approved M Joni changed masculine pronouns back to neutral Sep 22, 2014, 9:46:03 PM Unreviewed Artist minor grammar mainly, spaces for TOC Aug 13, 2014, 12:45:20 PM Approved user917725 removed share article Jul 21, 2014, 6:53:33 AM Approved M Joni Hid short links section Jul 21, 2014, 6:52:26 AM Unreviewed Joni updated short link section Dec 18, 2013, 1:57:34 AM Approved Michael Verdi removed redundant step Dec 17, 2013, 10:26:31 PM Approved debjanichatterjee added a line -Copy the shortened link and paste it wherever necessary. Oct 18, 2013, 7:06:55 PM Approved Rabbi Hossain Added Share Article Template Jun 27, 2013, 1:21:55 AM Approved M AliceWyman Do not use a colon in the article title since it prevents creating a wiki link to that article (bug 749835) May 9, 2013, 4:42:10 AM Approved M Michael Verdi Added instructions for creating mzl.la links May 9, 2013, 4:23:02 AM Approved M Michael Verdi Added info about the share template May 1, 2013, 5:52:23 AM Approved M Michael Verdi Finally added full sections about titles and summaries from our workshops, removed i.e. and e.g., new headings, removed wiki style examples and linked to markup cheat sheet instead Jan 22, 2013, 1:00:52 PM Approved M adampeebleswrites changed "web site" to "website" Oct 28, 2012, 10:54:19 PM Reviewed rosieculps98 i still cant see the history.. Oct 4, 2012, 7:11:34 PM Approved M scoobidiver added new keyword article, not linkable example Sep 5, 2012, 8:53:16 PM Approved M scoobidiver minor fix Aug 27, 2012, 7:45:29 AM Unreviewed scoobidiver new title naming scheme, added slug, keyword and summary sections Nov 30, 2011, 11:35:03 PM Reviewed FireFox Support Oct 7, 2011, 10:59:19 PM Approved M scoobidiver Internet instead of internet, .org instead of .com, fixed link formatting Jun 13, 2011, 7:35:15 PM Approved AliceWyman minor fixes Jun 7, 2011, 12:44:59 AM Approved tterranigma syntax error May 4, 2011, 3:44:58 AM Approved michellerluna fixed one typo Mar 1, 2011, 10:58:09 PM Approved Michael Verdi Fixed typo Dec 9, 2010, 6:36:09 AM Approved M Michael Verdi changed link to the new for article Dec 8, 2010, 12:01:35 AM Approved M Michael Verdi reorganized, moved some information to another document Nov 30, 2010, 5:53:49 PM Reviewed žełvik fixed a contradictory example Nov 30, 2010, 9:55:26 AM Approved M Michael Verdi 1st draft Compare Selected Revisions You are about to mark this revision as Ready for Localization. Are you sure you wish to proceed? Submit Cancel Document contributors AliceWyman Chris Ilias Michael Verdi scoobidiver michellerluna tterranigma Mozinet adampeebleswrites Kiki Rabbi Hossain debjanichatterjee Joni Artist John E Case Angela Lazar gleb-urencev Stacy Lema kefyalew Steven Erin S. Jessica Raymond Fabi JeremyKoozar Lucas Siebert