From a966a8b4eade72a13de8a688c13f2d5056321f02 Mon Sep 17 00:00:00 2001 From: Joshua Chen Date: Fri, 27 Sep 2024 06:24:11 -0400 Subject: [PATCH] Fix content issues (#36070) --- files/en-us/learn/css/building_blocks/organizing/index.md | 2 +- .../css/css_layout/practical_positioning_examples/index.md | 2 +- files/en-us/learn/css/styling_text/web_fonts/index.md | 2 +- .../what_will_your_website_look_like/index.md | 2 +- files/en-us/mdn/community/issues/index.md | 4 ++-- files/en-us/mdn/community/pull_requests/index.md | 2 +- .../add-ons/webextensions/api/webnavigation/index.md | 6 +++--- .../add-ons/webextensions/user_interface/omnibox/index.md | 2 +- files/en-us/web/api/navigator/scheduling/index.md | 2 +- files/en-us/web/api/scheduling/index.md | 2 +- files/en-us/web/api/scheduling/isinputpending/index.md | 2 +- 11 files changed, 14 insertions(+), 14 deletions(-) diff --git a/files/en-us/learn/css/building_blocks/organizing/index.md b/files/en-us/learn/css/building_blocks/organizing/index.md index b6de822a7edd92c..0a33fddc876f462 100644 --- a/files/en-us/learn/css/building_blocks/organizing/index.md +++ b/files/en-us/learn/css/building_blocks/organizing/index.md @@ -332,7 +332,7 @@ Read more about this system [BEM 101](https://css-tricks.com/bem-101/) on CSS Tr #### Other common systems -There are a large number of these systems in use. Other popular approaches include [Scalable and Modular Architecture for CSS (SMACSS)](https://smacss.com/), created by Jonathan Snook, [ITCSS](https://itcss.io/) from Harry Roberts, and [Atomic CSS (ACSS)](https://acss.io/), originally created by Yahoo!. If you come across a project that uses one of these approaches, then the advantage is that you will be able to search and find many articles and guides to help you understand how to code in the same style. +There are a large number of these systems in use. Other popular approaches include [Scalable and Modular Architecture for CSS (SMACSS)](https://smacss.com/), created by Jonathan Snook, [ITCSS](https://itcss.io/) from Harry Roberts, and [Atomizer CSS (ACSS)](https://acss-io.github.io/atomizer/), originally created by Yahoo!. If you come across a project that uses one of these approaches, then the advantage is that you will be able to search and find many articles and guides to help you understand how to code in the same style. The disadvantage of using such a system is that they can seem overly complex, especially for smaller projects. diff --git a/files/en-us/learn/css/css_layout/practical_positioning_examples/index.md b/files/en-us/learn/css/css_layout/practical_positioning_examples/index.md index 9763fb5e047c8bf..cae4a47972d6ec8 100644 --- a/files/en-us/learn/css/css_layout/practical_positioning_examples/index.md +++ b/files/en-us/learn/css/css_layout/practical_positioning_examples/index.md @@ -258,7 +258,7 @@ In our second example, we will take our first example — our info-box — and a > [!NOTE] > You can see the finished example running live at [fixed-info-box.html](https://mdn.github.io/learning-area/css/css-layout/practical-positioning-examples/fixed-info-box.html) ([source code](https://github.com/mdn/learning-area/blob/main/css/css-layout/practical-positioning-examples/fixed-info-box.html)). Check it out to get an idea of what you will be building in this section of the article. -As a starting point, you can use your completed example from the first section of the article, or make a local copy of [info-box.html](https://github.com/mdn/learning-area/blob/main/css/css-layout/practical-positioning-examples/info-box.html) from our GitHub repo. +As a starting point, you can use your completed example from the first section of the article, or make a local copy of [tabbed-info-box.html](https://github.com/mdn/learning-area/blob/main/css/css-layout/practical-positioning-examples/tabbed-info-box.html) from our GitHub repo. ### HTML additions diff --git a/files/en-us/learn/css/styling_text/web_fonts/index.md b/files/en-us/learn/css/styling_text/web_fonts/index.md index 67746b51cf8c4e0..3da26ecf79b015b 100644 --- a/files/en-us/learn/css/styling_text/web_fonts/index.md +++ b/files/en-us/learn/css/styling_text/web_fonts/index.md @@ -119,7 +119,7 @@ Web services for font generation typically limit file sizes. In such a case, con 1. [sfnt2woff-zopfli](https://github.com/bramstein/sfnt2woff-zopfli) for converting ttf to woff 2. [fontforge](https://fontforge.org/) for converting from ttf to svg -3. [batik ttf2svg](https://people.apache.org/~clay/batik/ttf2svg.html) for converting from ttf to svg +3. [batik ttf2svg](https://xmlgraphics.apache.org/batik/tools/font-converter.html) for converting from ttf to svg 4. [woff2](https://github.com/google/woff2) for converting from ttf to woff2 ### Implementing the code in your demo diff --git a/files/en-us/learn/getting_started_with_the_web/what_will_your_website_look_like/index.md b/files/en-us/learn/getting_started_with_the_web/what_will_your_website_look_like/index.md index e69248133149055..5bf53da692ce1f1 100644 --- a/files/en-us/learn/getting_started_with_the_web/what_will_your_website_look_like/index.md +++ b/files/en-us/learn/getting_started_with_the_web/what_will_your_website_look_like/index.md @@ -21,7 +21,7 @@ To begin, you'll need to answer these questions: 3. **What does your website look like,** in simple high-level terms? What's the background color? What kind of font is appropriate: formal, cartoony, bold and loud, subtle? > [!NOTE] -> Complex projects need detailed guidelines that go into all the details of colors, fonts, spacing between items on a page, appropriate writing style, and so on. This is sometimes called a design guide, design system, or brand book, and you can see an example at the [Firefox Acorn Design System](https://acorn.firefox.com/latest/). +> Complex projects need detailed guidelines that go into all the details of colors, fonts, spacing between items on a page, appropriate writing style, and so on. This is sometimes called a design guide, design system, or brand book, and you can see an example at the [Firefox Acorn Design System](https://acorn.firefox.com/latest). ## Sketching out your design diff --git a/files/en-us/mdn/community/issues/index.md b/files/en-us/mdn/community/issues/index.md index ffb7de143ad1e3f..5316815665c88df 100644 --- a/files/en-us/mdn/community/issues/index.md +++ b/files/en-us/mdn/community/issues/index.md @@ -103,7 +103,7 @@ These are the general steps for working on an issue: > [!NOTE] > An issue with the `needs triage` label indicates that the MDN Web Docs core team has not reviewed the issue yet, and you shouldn't begin work on it. -2. **Assign the issue to yourself:** After finding an issue you'd like to work on, make sure that the issue is not assigned to anybody else. Add a comment saying you would like to work on the issue, and if you are able to, [assign the issue to yourself](https://docs.github.com/en/issues/tracking-your-work-with-issues/assigning-issues-and-pull-requests-to-other-github-users#assigning-an-individual-issue-or-pull-request). +2. **Assign the issue to yourself:** After finding an issue you'd like to work on, make sure that the issue is not assigned to anybody else. Add a comment saying you would like to work on the issue, and if you are able to, [assign the issue to yourself](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users#assigning-an-individual-issue-or-pull-request). 3. **Do the research:** Most issues need some investigation before work can start. @@ -111,7 +111,7 @@ These are the general steps for working on an issue: - If the issue is well-described, and the work is pretty obvious, go ahead and do it. - If the issue is not well-described, and/or you are not sure what is needed, feel free to @mention the poster and ask for more information. -4. **Make the changes:** Fork and branch the repository. Do your work and open a [pull request](/en-US/docs/MDN/Community/Pull_requests) in the repository. [Reference the issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue) in the pull request description. Depending on the files you've updated in the pull request, a reviewer will be assigned to your pull request automatically. (Teams per topic area are defined in the [CODEOWNERS](https://github.com/mdn/content/blob/main/.github/CODEOWNERS) file). +4. **Make the changes:** Fork and branch the repository. Do your work and open a [pull request](/en-US/docs/MDN/Community/Pull_requests) in the repository. [Reference the issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue) in the pull request description. Depending on the files you've updated in the pull request, a reviewer will be assigned to your pull request automatically. (Teams per topic area are defined in the [CODEOWNERS](https://github.com/mdn/content/blob/main/.github/CODEOWNERS) file). After opening the pull request, if you find you no longer have the time to make changes or incorporate review feedback, let the team know as soon as possible in a comment in the pull request. This will help the team assign another interested contributor to complete the work on the pull request and close the linked issue. diff --git a/files/en-us/mdn/community/pull_requests/index.md b/files/en-us/mdn/community/pull_requests/index.md index 05761cfa36c65ac..bc75f4ffe3626e7 100644 --- a/files/en-us/mdn/community/pull_requests/index.md +++ b/files/en-us/mdn/community/pull_requests/index.md @@ -62,7 +62,7 @@ When you're ready to open a pull request, follow these guidelines: If a pull request becomes too large, the reviewer may close it and ask that you to submit pull requests for each logical set of changes that belong together. - **Add a description of the changes:** Provide as much context and rationale for the pull request as possible. - **Add the link to the issue you are closing:** In the pull request description, add 'Fixes' if it fully resolves the issue or 'Relates to' if it is a related issue. - More information about linking to issues in pull requests can be found in [GitHub docs](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword). + More information about linking to issues in pull requests can be found in [GitHub docs](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword). - **Add 'depends on'** with a link to a dependency if there are pull requests that must be merged first (e.g., code examples in other repositories). - **Accompany code example changes with content changes:** This is important to ensure that updated examples are served correctly. If you're making content changes that affect how examples are used, the related code examples should also be updated. diff --git a/files/en-us/mozilla/add-ons/webextensions/api/webnavigation/index.md b/files/en-us/mozilla/add-ons/webextensions/api/webnavigation/index.md index ef40b20e525dc55..39749671dba3630 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/webnavigation/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/webnavigation/index.md @@ -25,8 +25,8 @@ Each event corresponds to a particular stage in the navigation. The sequence of - Additionally: - `{{WebExtAPIRef("webNavigation.onCreatedNavigationTarget", "onCreatedNavigationTarget")}}` is fired before `onBeforeNavigate` if the browser needed to create a new tab or window for the navigation (for example, because the user opened a link in a new tab). - - {{WebExtAPIRef("webNavigation.onHistoryStateUpdated", "onHistoryStateUpdated")}} is fired if a page uses the [history API (2011)](http://diveintohtml5.info/history.html) to update the URL displayed in the browser's location bar. - - {{WebExtAPIRef("webNavigation.onReferenceFragmentUpdated", "onReferenceFragmentUpdated")}} is fired if the [fragment identifier](https://en.wikipedia.org/wiki/Fragment_identifier) for a page is changed. + - {{WebExtAPIRef("webNavigation.onHistoryStateUpdated", "onHistoryStateUpdated")}} is fired if a page uses the [history API](/en-US/docs/Web/API/History_API) to update the URL displayed in the browser's location bar. + - {{WebExtAPIRef("webNavigation.onReferenceFragmentUpdated", "onReferenceFragmentUpdated")}} is fired if the [fragment identifier](/en-US/docs/Web/URI/Fragment) for a page is changed. - {{WebExtAPIRef("webNavigation.onErrorOccurred", "onErrorOccurred")}} can be fired at any point. Each navigation is a URL transition in a particular browser frame. The browser frame is identified by a tab ID and a frame ID. The frame may be the top-level browsing context in the tab, or may be a nested browsing context implemented as an [iframe](/en-US/docs/Web/HTML/Element/iframe). @@ -70,7 +70,7 @@ To use this API you need to have the "webNavigation" [permission](/en-US/docs/Mo - {{WebExtAPIRef("webNavigation.onTabReplaced")}} - : Fired when the contents of the tab is replaced by a different (usually previously pre-rendered) tab. - {{WebExtAPIRef("webNavigation.onHistoryStateUpdated")}} - - : Fired when the page used the [history API (2011)](http://diveintohtml5.info/history.html) to update the URL displayed in the browser's location bar. + - : Fired when the page used the [history API (2011)](/en-US/docs/Web/API/History_API) to update the URL displayed in the browser's location bar. ## Browser compatibility diff --git a/files/en-us/mozilla/add-ons/webextensions/user_interface/omnibox/index.md b/files/en-us/mozilla/add-ons/webextensions/user_interface/omnibox/index.md index 42247387afacd40..31c1a2708d6b5ed 100644 --- a/files/en-us/mozilla/add-ons/webextensions/user_interface/omnibox/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/user_interface/omnibox/index.md @@ -29,7 +29,7 @@ browser.omnibox.setDefaultSuggestion({ }); ``` -You can then add the code to provide the customized content by listening for {{WebExtAPIRef("omnibox.onInputStarted")}}, which is dispatched when the user has typed the keyword and a space, and {{WebExtAPIRef("omnibox.onInputChanged")}}, which is dispatched whenever the user updates the address bar entry. You can then populate the suggestions, in this case building a [search of mozilla-central](https://searchfox.org/mozilla-central) using the term entered by the user: +You can then add the code to provide the customized content by listening for {{WebExtAPIRef("omnibox.onInputStarted")}}, which is dispatched when the user has typed the keyword and a space, and {{WebExtAPIRef("omnibox.onInputChanged")}}, which is dispatched whenever the user updates the address bar entry. You can then populate the suggestions, in this case building a [search of mozilla-central](https://searchfox.org/mozilla-central/search) using the term entered by the user: ```js browser.omnibox.onInputChanged.addListener((text, addSuggestions) => { diff --git a/files/en-us/web/api/navigator/scheduling/index.md b/files/en-us/web/api/navigator/scheduling/index.md index 612e91b1d8c32a2..9d45a1438af8b82 100644 --- a/files/en-us/web/api/navigator/scheduling/index.md +++ b/files/en-us/web/api/navigator/scheduling/index.md @@ -34,7 +34,7 @@ See the {{domxref("Scheduling.isInputPending()")}} page for a full example. ## See also - {{domxref("Scheduler")}} interface -- {{domxref("Prioritized_task_scheduling_api", "Prioritized Task Scheduling API")}} +- {{domxref("Prioritized_task_scheduling_api", "Prioritized Task Scheduling API", "", "nocode")}} - [Faster input events with Facebook's first browser API contribution](https://engineering.fb.com/2019/04/22/developer-tools/isinputpending-api/) on engineering.fb.com (2019) - [Better JS scheduling with isInputPending()](https://developer.chrome.com/docs/capabilities/web-apis/isinputpending) on developer.chrome.com (2020) - [Optimizing long tasks](https://web.dev/articles/optimize-long-tasks) on web.dev (2022) diff --git a/files/en-us/web/api/scheduling/index.md b/files/en-us/web/api/scheduling/index.md index 784a65ad7d307d1..a5f83624517bff2 100644 --- a/files/en-us/web/api/scheduling/index.md +++ b/files/en-us/web/api/scheduling/index.md @@ -34,7 +34,7 @@ See the {{domxref("Scheduling.isInputPending()")}} page for a full example. ## See also - {{domxref("Scheduler")}} interface -- {{domxref("Prioritized_task_scheduling_api", "Prioritized Task Scheduling API")}} +- {{domxref("Prioritized_task_scheduling_api", "Prioritized Task Scheduling API", "", "nocode")}} - [Faster input events with Facebook's first browser API contribution](https://engineering.fb.com/2019/04/22/developer-tools/isinputpending-api/) on engineering.fb.com (2019) - [Better JS scheduling with isInputPending()](https://developer.chrome.com/docs/capabilities/web-apis/isinputpending) on developer.chrome.com (2020) - [Optimizing long tasks](https://web.dev/articles/optimize-long-tasks) on web.dev (2022) diff --git a/files/en-us/web/api/scheduling/isinputpending/index.md b/files/en-us/web/api/scheduling/isinputpending/index.md index 01304501c5652b2..5e4f05b021196a4 100644 --- a/files/en-us/web/api/scheduling/isinputpending/index.md +++ b/files/en-us/web/api/scheduling/isinputpending/index.md @@ -80,7 +80,7 @@ This allows you to avoid blocking the main thread when the user is actively inte ## See also - {{domxref("Scheduler")}} interface -- {{domxref("Prioritized_task_scheduling_api", "Prioritized Task Scheduling API")}} +- {{domxref("Prioritized_task_scheduling_api", "Prioritized Task Scheduling API", "", "nocode")}} - [Faster input events with Facebook's first browser API contribution](https://engineering.fb.com/2019/04/22/developer-tools/isinputpending-api/) on engineering.fb.com (2019) - [Better JS scheduling with isInputPending()](https://developer.chrome.com/docs/capabilities/web-apis/isinputpending) on developer.chrome.com (2020) - [Optimizing long tasks](https://web.dev/articles/optimize-long-tasks#yield_only_when_necessary) on web.dev (2022)