diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_constructor_subpage_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_constructor_subpage_template/index.md index 7d1b2c18e7d1b23..1bded90d6d1f39c 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_constructor_subpage_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_constructor_subpage_template/index.md @@ -149,6 +149,7 @@ See our guide on how to add [code examples](/en-US/docs/MDN/Writing_guidelines/P ## See also -- Include list of -- other links related to -- this API that might be useful +Include links to reference pages and guides related to the current API. For more guidelines, see the [See also section](/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#see_also_section) in the _Writing style guide_. + +- link1 +- link2 diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_event_subpage_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_event_subpage_template/index.md index b23c522cf6d8365..d31cf5d9f573d47 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_event_subpage_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_event_subpage_template/index.md @@ -179,6 +179,7 @@ See our guide on how to add [code examples](/en-US/docs/MDN/Writing_guidelines/P ## See also -- Include list of -- other links related to -- this API that might be useful +Include links to reference pages and guides related to the current API. For more guidelines, see the [See also section](/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#see_also_section) in the _Writing style guide_. + +- link1 +- link2 diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_landing_page_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_landing_page_template/index.md index abb4762722048f4..671a2d99feaa7e0 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_landing_page_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_landing_page_template/index.md @@ -174,6 +174,7 @@ See our guide on how to add [code examples](/en-US/docs/MDN/Writing_guidelines/P ## See also -- Include list of -- other links related to -- this API that might be useful +Include links to reference pages and guides related to the current API. For more guidelines, see the [See also section](/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#see_also_section) in the _Writing style guide_. + +- link1 +- link2 diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_method_subpage_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_method_subpage_template/index.md index f2d2abcd232c464..7b0485831fa4562 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_method_subpage_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_method_subpage_template/index.md @@ -165,6 +165,7 @@ See our guide on how to add [code examples](/en-US/docs/MDN/Writing_guidelines/P ## See also -- Include list of -- other links related to -- this API that might be useful +Include links to reference pages and guides related to the current API. For more guidelines, see the [See also section](/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#see_also_section) in the _Writing style guide_. + +- link1 +- link2 diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_property_subpage_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_property_subpage_template/index.md index 910dbf521459466..84696ead22dc059 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_property_subpage_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_property_subpage_template/index.md @@ -130,6 +130,7 @@ See our guide on how to add [code examples](/en-US/docs/MDN/Writing_guidelines/P ## See also -- Include list of -- other links related to -- this API that might be useful +Include links to reference pages and guides related to the current API. For more guidelines, see the [See also section](/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#see_also_section) in the _Writing style guide_. + +- link1 +- link2 diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_reference_page_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_reference_page_template/index.md index 7f716ef12ee4e7c..02aaa42a1482d03 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_reference_page_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_reference_page_template/index.md @@ -160,7 +160,7 @@ See our guide on how to add [code examples](/en-US/docs/MDN/Writing_guidelines/P ## See also -- Include list of -- other links related to -- this API that might -- be useful +Include links to reference pages and guides related to the current API. For more guidelines, see the [See also section](/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#see_also_section) in the _Writing style guide_. + +- link1 +- link2 diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/aria_page_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/aria_page_template/index.md index a25870764bf6a11..ebaee3d2dcc6c65 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/aria_page_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/aria_page_template/index.md @@ -132,7 +132,7 @@ What are the related properties, and in what order will this attribute or proper ## See also -- Include list of -- other links related to -- this role or attribute that might -- be useful +Include links to reference pages and guides related to the current role or attribute. For more guidelines, see the [See also section](/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#see_also_section) in the _Writing style guide_. + +- link1 +- link2 diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_property_page_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_property_page_template/index.md index 0e562d892a5ac8e..15000167089c1cb 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_property_page_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_property_page_template/index.md @@ -175,7 +175,7 @@ _Remember to remove the backticks and backslash to use this macro._ ## See also -Include guides relating to the current property or a list of other properties here. +Include links to reference pages and guides related to the current property. For more guidelines, see the [See also section](/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#see_also_section) in the _Writing style guide_. - link1 - link2 diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_selector_page_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_selector_page_template/index.md index 4e92339b4fd2de3..14b857ac25b52ab 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_selector_page_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_selector_page_template/index.md @@ -137,7 +137,7 @@ Remove this section if there are none to list. ## See also -- Include list of -- other links related to -- this Element that might -- be useful +Include links to reference pages and guides related to the current selector. For more guidelines, see the [See also section](/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#see_also_section) in the _Writing style guide_. + +- link1 +- link2 diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/glossary_page_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/glossary_page_template/index.md index 7a900353cc942b7..157535574a122ff 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/glossary_page_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/glossary_page_template/index.md @@ -42,5 +42,7 @@ Include further supporting information as required, but not much β€” no more tha ## See also -- Include list of links pointing to more detailed general and technical information. -- For example Wikipedia articles, other encyclopedia entries, technical tutorials, specifications. +Include a list of links pointing to more detailed general and technical information. For example, you can add links to Wikipedia articles, other encyclopedia entries, technical tutorials, and specifications. For guidelines on adding this list of links, see the [See also section](/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#see_also_section) in the _Writing style guide_. + +- link1 +- link2 diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/html_element_page_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/html_element_page_template/index.md index e76e4c8c5f4e81f..a451a1c7602b7e3 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/html_element_page_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/html_element_page_template/index.md @@ -200,6 +200,7 @@ Optionally, warn of any potential accessibility concerns that exist with using t ## See also -- Include list of -- other links related to -- this Element that might be useful +Include links to reference pages and guides related to the current element. For more guidelines, see the [See also section](/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#see_also_section) in the _Writing style guide_. + +- link1 +- link2 diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/http_header_page_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/http_header_page_template/index.md index aaec2e4246ce906..47169daba1c6fe1 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/http_header_page_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/http_header_page_template/index.md @@ -159,7 +159,7 @@ See our guide on how to add [code examples](/en-US/docs/MDN/Writing_guidelines/P ## See also -- Include list of -- other links related to -- this header that might -- be useful +Include links to reference pages and guides related to the current HTTP header. For more guidelines, see the [See also section](/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#see_also_section) in the _Writing style guide_. + +- link1 +- link2 diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/svg_element_page_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/svg_element_page_template/index.md index fc0275d49ee12fd..04bdb4edc3426ca 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/svg_element_page_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/svg_element_page_template/index.md @@ -149,6 +149,7 @@ See our guide on how to add [code examples](/en-US/docs/MDN/Writing_guidelines/P ## See also -- Include list of -- other links related to -- this Element that might be useful +Include links to reference pages and guides related to the current element. For more guidelines, see the [See also section](/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#see_also_section) in the _Writing style guide_. + +- link1 +- link2 diff --git a/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md b/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md index ab3b443485aefc4..881fddeab2c529b 100644 --- a/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md +++ b/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md @@ -16,7 +16,16 @@ After listing the general writing guidelines, this guide describes the recommend ## General writing guidelines -The goal is to write pages that include all the information that readers may need for understanding the topic at hand. Following are some recommendations to achieve this. +The goal is to write pages that include all the information that readers may need for understanding the topic at hand. + +The following subsections provide the recommendations to achieve this: + +- [Consider your target audience](#consider_your_target_audience) +- [Consider the three Cs of writing](#consider_the_three_cs_of_writing) +- [Include relevant examples](#include_relevant_examples) +- [Provide a descriptive introduction](#provide_a_descriptive_introduction) +- [Use inclusive language](#use_inclusive_language) +- [Write with SEO in mind](#write_with_seo_in_mind) ### Consider your target audience @@ -152,6 +161,18 @@ The following checklist is good to keep in mind while writing and reviewing cont Other than writing grammatically correct sentences in English, we recommend you follow these guidelines to keep content consistent across MDN Web Docs. +- [Abbreviations and acronyms](#abbreviations_and_acronyms) +- [Capitalization](#capitalization) +- [Contractions](#contractions) +- [Numbers and numerals](#numbers_and_numerals) +- [Pluralization](#pluralization) +- [Apostrophes and quotation marks](#apostrophes_and_quotation_marks) +- [Commas](#commas) +- [Hyphens](#hyphens) +- [Spelling](#spelling) +- [Terminology](#terminology) +- [Voice](#voice) + ### Abbreviations and acronyms An abbreviation is a shortened version of a longer word, while an acronym is a new word created using the first letter of each word from a phrase. This section describes guidelines for abbreviations and acronyms. @@ -339,10 +360,10 @@ Use American-English spelling. In general, use the first entry at [Dictionary.com](https://www.dictionary.com/), unless that entry is listed as a variant spelling or as being primarily used in a non-American form of English. For example, if you [look up "behaviour"](https://www.dictionary.com/browse/behaviour)(with an additional _u_ added to the American standard form), you find the phrase "Chiefly British" followed by a link to the American standard form, ["behavior"](https://www.dictionary.com/browse/behavior). -Do not use variant spellings. +Do not use variant spelling. -- **Correct**: localize, behavior -- **Incorrect**: localise, behaviour +- **Correct**: localize, behavior, color +- **Incorrect**: localise, behaviour, colour ### Terminology @@ -371,6 +392,17 @@ Try to be consistent, though. This section lists the guidelines to follow for components such as headings, notes, links, and examples that commonly appear on a page. +- [Code examples](#code_examples) +- [External links](#external_links) +- [Shortened URLs (shortlinks)](#shortened_urls_shortlinks) +- [Heading levels](#heading_levels) +- [Images and other media](#images_and_other_media) +- [Lists](#lists) +- [See also section](#see_also_section) +- [Subpages](#subpages) +- [Slugs](#slugs) +- [Titles](#titles) + ### Code examples A page on MDN Web Docs can contain more than one code example. The following list presents some recommended practices when writing a code example for MDN Web Docs: @@ -419,11 +451,13 @@ In general, if you're considering adding an external link, you need to ensure th Sometimes such links are relevant and appropriate. For example, if you're the editor of a specification and you're contributing to documentation related to that specification, then linking to that specification is expected and acceptable. But you must disclose the relationship between you and the link. -#### Shortened URLs (shortlinks) +### Shortened URLs (shortlinks) + +A URL shortener (such as TinyURL or Bitly) can be great for shortening long links into small, easier-to-remember URLs (also known as "shortlinks"). However, they also obfuscate the destination of the URL. Additionally, with certain shorteners, the destination can be changed after their creation, a feature that could be utilized for malicious purposes. -A URL shortener (such as TinyURL or Bitly) can be great for shortening long links into small, easier-to-remember URLs (also known as "shortlinks"). However, they also obfuscate the destination of the URL β€” and with certain shorteners, the destination can be changed after their creation, a feature that can be utilized for malicious purposes. Do not use links created via third-party (user-generatable) URL shorteners. For example, if `https://myshort.link/foobar` is a short URL generated by a random user and redirects to `https://example.com/somelongURL/details/show?page_id=foobar`, use the longer `example.com` URL. +Do not use links created via third-party (user-generatable) URL shorteners. For example, if `https://myshort.link/foobar` is a short URL generated by a random user and redirects to `https://example.com/somelongURL/details/show?page_id=foobar`, use the longer `example.com` URL. -On the other hand, first-party shorteners that are maintained by the organizations that also maintain the destination URLs are encouraged. `https://bugzil.la` is owned and operated by Mozilla, and is a URL shortener that redirects to `https://bugzilla.mozilla.org/` (which is also a Mozilla-owned domain). In this case, use the shorter URL. For example, use `https://bugzil.la/1682349` instead of `https://bugzilla.mozilla.org/show_bug.cgi?id=1682349`. +On the other hand, first-party shorteners that are maintained by the organizations that also maintain the destination URLs are encouraged. `https://bugzil.la` is owned and operated by Mozilla and is a URL shortener that redirects to `https://bugzilla.mozilla.org/`, which is also a Mozilla-owned domain. In this case, use the shorter URL. For example, use `https://bugzil.la/1682349` instead of `https://bugzilla.mozilla.org/show_bug.cgi?id=1682349`. ### Heading levels @@ -456,17 +490,26 @@ Lists should be formatted and structured consistently across all pages. Individual list items should be written with suitable punctuation, regardless of the list format. However, depending on the type of list you are creating, you will want to adjust your writing as described in the sections below. In both cases, include a lead-in sentence that describes the information in the list. -- **Bulleted lists**: Bulleted lists should be used to group related pieces of concise information. Each item in the list should follow a similar sentence structure. Phrases and sentences in bulleted lists should include standard punctuation. A period must appear at the end of each sentence in a bulleted list, including the item's final sentence, just as would be expected in a paragraph. +- **Bulleted lists**: Bulleted lists should be used to group related pieces of concise information. Each item in the list should follow a similar sentence structure. Sentences and phrases (i.e., sentence fragments missing a verb or a subject or both) in bulleted lists should include standard punctuation β€” sentences end with periods, phrases don't. - This is an example of a correctly structured bulleted list: +If there are multiple sentences in a list item, a period must appear at the end of each sentence, including the item's final sentence, just as would be expected in a paragraph. This is an example of a correctly structured bulleted list: - > In this example, we should include: - > - > - A condition, with a brief explanation. - > - A similar condition, with a brief explanation. - > - Yet another condition, with some further explanation. +> In this example, we should include: +> +> - A condition, with a brief explanation. +> - A similar condition, with a brief explanation. +> - Yet another condition, with some further explanation. + +Notice how the same sentence structure repeats from bullet to bullet. In this example, each bullet point states a condition followed by a comma and a brief explanation, and each item in the list ends with a period. + +If the list items include incomplete sentences, no period is required at the end. For example: - Notice how the same sentence structure repeats from bullet to bullet. In this example, each bullet point states a condition followed by a comma and a brief explanation, and each item in the list ends with a period. +> The following color-related properties will be helpful in this scenario: +> +> - propertyA: Sets the background color +> - propertyB: Adds shadow to text + +If one or more list items are complete sentences, use a period after every list item, even if a list item contains three or fewer words. However, as far as possible, follow the same structure for all items in a list; ensure all list items are either complete sentences or phrases. - **Numbered lists**: Numbered lists are used primarily to enumerate steps in a set of instructions. Because instructions can be complex, clarity is a priority, especially if the text in each list item is lengthy. As with bulleted lists, follow standard punctuation usage. This is an example of a correctly structured numbered list: @@ -483,6 +526,41 @@ However, depending on the type of list you are creating, you will want to adjust Notice how the items in numbered lists read like short paragraphs. Because numbered lists are routinely used for instructional purposes or to walk someone through an orderly procedure, be sure to keep each item focused: one numbered item per step. +### See also section + +Most of the guides, reference pages, and even glossary pages on MDN Web Docs contain a _See also_ section at the end of the article. This is a reference section containing cross-references to related topics within MDN and sometimes links to related external articles. For example, this is the [See also section](/en-US/docs/Web/CSS/@layer#see_also) for the `@layer` page. + +In general, present the links in a See also section in a [bulleted list](#lists) format with each item in the list as a phrase. In the [Learn web development](/en-US/docs/Learn) area on MDN, however, the See also section follows the [definition list](/en-US/docs/MDN/Writing_guidelines/Howto/Markdown_in_MDN#definition_lists) format. + +To maintain consistency across MDN Web Docs, keep the following guidelines in mind while adding or updating a See also section. + +#### Link text + +- The link text should be the same as the title of the page or the section being linked to. For example, the link text to this [ARIA](/en-US/docs/Web/Accessibility/ARIA/Attributes) page will be: + - **Correct**: [ARIA states and properties](/en-US/docs/Web/Accessibility/ARIA/Attributes) +- Use sentence casing in the link text even if it is different from the linked page title or section title. It might be that the case used in the page or section title is incorrect. For example, the link text to the [WAI-ARIA Roles](/en-US/docs/Web/Accessibility/ARIA/Roles) page will be: + - **Correct**: [WAI-ARIA roles](/en-US/docs/Web/Accessibility/ARIA/Roles) +- For external links as well, use sentence casing even if the casing on the target article page is different. This is to ensure consistency across MDN Web Docs. Exceptions include names of books. +- Use the appropriate macro to link to a page as defined in the [Linking to pages in references](/en-US/docs/MDN/Writing_guidelines/Page_structures/Macros/Commonly_used_macros#linking_to_pages_in_references) section. The use of macro will add code formatting to the keyword in the link text, as shown in the previous example. +- No article ("A", "An", "The") is needed at the beginning of the link list item. No punctuation is required after a link text because it will invariably be a term or a phrase. + - **Correct**: {{cssxref("revert-layer")}} + - **Incorrect**: The {{cssxref("revert-layer")}} keyword. + +#### Descriptive text + +- Keep the descriptive text surrounding the link minimal. In case of a description, add it after the link text and a colon. Word the description as a phrase with no ending punctuation. Keep all linked text at the beginning to aid in scanning the list of links. + - **Correct**: {{cssxref(":checked")}}, {{cssxref(":indeterminate")}}: CSS selectors for styling checkboxes +- Don't use the conjunction "and" before the last item in the series. + - **Correct**: {{cssxref("background-color")}}, {{cssxref("border-color")}}, {{cssxref("color")}}, {{cssxref("caret-color")}}, {{cssxref("column-rule-color")}}, {{cssxref("outline-color")}}, {{cssxref("text-decoration-color")}}, {{cssxref("text-emphasis-color")}}, {{cssxref("text-shadow")}}: Other color-related properties +- After an external link and the source website, mention the date or year when the article was published within parentheses. Specify date using the format "January 1, 1900". The publication date not only helps to inform the readers about the relevance of the linked content but also helps authors to review links that are very old. For example, to link to the [Top-level await](https://v8.dev/features/top-level-await) external article, the reference will be: + - [Top-level await](https://v8.dev/features/top-level-await) on v8.dev (October 8, 2019) + +#### Order of links + +- For cross-referencing within MDN, list the links to reference pages first and then the links to the related guide, and tutorial pages. +- If the list is a mix of internal and external links, list the internal links first and then the external ones. +- Within each group of internal and external links, follow alphabetical or simple-to-advanced order, whatever makes more sense for the context. + ### Subpages When you need to add some articles about a topic or subject area, you will typically do so by creating a landing page, then adding subpages for each of the individual articles. @@ -533,28 +611,25 @@ Keep the following guidelines in mind when writing titles: - **Don't begin with article**: Avoid starting titles with articles "a", "an", or "the". - **Add lead-in information**: After a title, add some introductory text to explain what will be covered in the section. -## See also +## Further reading ### Preferred style guides -If you have questions about usage and style not covered here, we recommend referring to the [Microsoft Writing Style Guide](https://docs.microsoft.com/style-guide/welcome/)β€”or, failing that, the [Chicago Manual of Style](https://www.amazon.com/Chicago-Manual-Style-16th/dp/0226104206). +If you have questions about usage and style not covered here, we recommend referring to the [Microsoft Writing Style Guide](https://docs.microsoft.com/style-guide/welcome/) or the [Chicago Manual of Style](https://www.chicagomanualofstyle.org). An [unofficial crib sheet for the Chicago Manual of Style](https://faculty.cascadia.edu/cma/HIST148/cmscrib.pdf) is available online. ### Preferred dictionary -For questions of spelling, please refer to [Dictionary.com](https://www.dictionary.com/). +For questions about spelling, refer to [Dictionary.com](https://www.dictionary.com/). The spelling checker for this site uses American English. -Please do not use variant spellings (e.g., use _color_ rather than _colour_). - -We will be expanding the guide over time, so if you have specific questions that aren't covered in this document, [please get in touch](/en-US/docs/MDN/Community/Contributing/Getting_started#step_4_ask_for_help), so we know what should be added. ### Language, grammar, and spelling If you're interested in improving your writing and editing skills, you may find the following resources to be helpful. -- [On Writing Well](https://www.amazon.com/Writing-Well-30th-Anniversary-Nonfiction/dp/0060891548), by William Zinsser (Amazon link) -- [Style: The Basics of Clarity and Grace](https://www.amazon.com/Style-Basics-Clarity-Grace-4th/dp/0205830765/), by Joseph Williams and Gregory Colomb (Amazon link) -- [Common Errors in English](https://brians.wsu.edu/common-errors-in-english-usage/) -- [English Grammar FAQ](https://www-personal.umich.edu/~jlawler/aue.html) (alt.usage.english) -- [Merriam-Webster's Concise Dictionary of English Usage](https://www.amazon.com/Merriam-Websters-Concise-Dictionary-English-Usage/dp/B004L2KNI2) (Amazon link): Scholarly but user-friendly, evidence-based advice; very good for non-native speakers, especially for preposition usage. -- [English Language and Usage StackExchange](https://english.stackexchange.com/): Question and answer site for English language usage. +- [Common errors in English usage](https://brians.wsu.edu/common-errors-in-english-usage/) on brians.wsu.edu +- [English grammar FAQ](https://www-personal.umich.edu/~jlawler/aue.html) on alt-usage-english.org +- [English language and usage](https://english.stackexchange.com/) on english.stackexchange.com: Question and answer site for English language usage +- [Merriam-Webster's Concise Dictionary of English Usage](https://www.google.com/books/edition/Merriam_Webster_s_Dictionary_of_English/UDIjAQAAIAAJ) on google.com/books (published 2002): Scholarly but user-friendly, evidence-based advice; very good for non-native speakers, especially for preposition usage +- [On Writing Well](https://www.harpercollins.com/products/on-writing-well-william-zinsser) by William Zinsser on harpercollins.com (published 2016) +- [Style: Lessons in Clarity and Grace](https://www.google.ca/books/edition/Style/QjskvgEACAAJ) by Joseph Williams and Gregory Colomb on google.com/books (published 2019) diff --git a/files/en-us/web/css/@layer/index.md b/files/en-us/web/css/@layer/index.md index 396e0e2a2578811..b631b0c0c231860 100644 --- a/files/en-us/web/css/@layer/index.md +++ b/files/en-us/web/css/@layer/index.md @@ -196,10 +196,11 @@ In the following example, two layers are created with no rules applied, then CSS ## See also - [`@import`](/en-US/docs/Web/CSS/@import) -- The two associated interfaces: {{domxref("CSSLayerBlockRule")}} and {{domxref("CSSLayerStatementRule")}} -- [The `!important` flag](/en-US/docs/Web/CSS/important) -- [The `revert-layer` keyword](/en-US/docs/Web/CSS/revert-layer) -- [Introducing the CSS Cascade](/en-US/docs/Web/CSS/Cascade) -- [CSS building block: cascade and inheritance](/en-US/docs/Learn/CSS/Building_blocks/Cascade_and_inheritance) -- [CSS building block: cascade layers](/en-US/docs/Learn/CSS/Building_blocks/Cascade_layers) -- [The Future of CSS: Cascade Layers](https://www.bram.us/2021/09/15/the-future-of-css-cascade-layers-css-at-layer/) +- {{domxref("CSSLayerBlockRule")}} +- {{domxref("CSSLayerStatementRule")}} +- [`!important`](/en-US/docs/Web/CSS/important) +- [`revert-layer`](/en-US/docs/Web/CSS/revert-layer) +- [Introducing the CSS cascade](/en-US/docs/Web/CSS/Cascade) +- [Cascade, specificity, and inheritance](/en-US/docs/Learn/CSS/Building_blocks/Cascade_and_inheritance) +- [Cascade layers](/en-US/docs/Learn/CSS/Building_blocks/Cascade_layers) +- [The future of CSS: Cascade layers](https://www.bram.us/2021/09/15/the-future-of-css-cascade-layers-css-at-layer/) on bram.us (September 15, 2021)