From dc6c5293527b4e17426c15c45a55e8ba40c1ba6c Mon Sep 17 00:00:00 2001
From: Leonid Vinogradov <win.leon@protonmail.com>
Date: Tue, 30 Jul 2024 00:17:43 +0300
Subject: [PATCH] [ru] replace old noteblock syntax with GFM syntax in
 'mozilla' folder

---
 .../webextensions/api/cookies/cookie/index.md |  3 +-
 .../webextensions/api/cookies/index.md        |  3 +-
 .../webextensions/api/downloads/index.md      |  3 +-
 .../api/runtime/getmanifest/index.md          |  3 +-
 .../webextensions/api/tabs/get/index.md       |  3 +-
 .../webextensions/api/webrequest/index.md     |  3 +-
 .../api/windows/createtype/index.md           |  3 +-
 .../webextensions/api/windows/index.md        |  3 +-
 .../chrome_incompatibilities/index.md         |  4 +-
 .../webextensions/content_scripts/index.md    | 54 +++++++++----------
 .../add-ons/webextensions/examples/index.md   |  3 +-
 .../internationalization/index.md             | 12 ++---
 .../manifest.json/icons/index.md              |  3 +-
 .../webextensions/manifest.json/index.md      |  6 ++-
 .../webextensions/match_patterns/index.md     |  5 +-
 .../webextensions/modify_a_web_page/index.md  | 21 ++++----
 .../webextensions/user_interface/index.md     |  3 +-
 .../your_first_webextension/index.md          |  9 ++--
 files/ru/mozilla/firefox/releases/68/index.md |  3 +-
 19 files changed, 79 insertions(+), 68 deletions(-)

diff --git a/files/ru/mozilla/add-ons/webextensions/api/cookies/cookie/index.md b/files/ru/mozilla/add-ons/webextensions/api/cookies/cookie/index.md
index 011f5f32551ebb..0b0377fad51c93 100644
--- a/files/ru/mozilla/add-ons/webextensions/api/cookies/cookie/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/api/cookies/cookie/index.md
@@ -58,7 +58,8 @@ gettingAll.then(logCookies);
 
 {{WebExtExamples}}
 
-> **Примечание:** Это API основано на API Chromium [`chrome.cookies`](https://developer.chrome.com/extensions/cookies#type-Cookie). Эта документация основана на [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) из кода Chromium.
+> [!NOTE]
+> Этот API основан на Chromium API [`chrome.cookies`](https://developer.chrome.com/extensions/cookies#type-Cookie). Эта документация основана на [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) из кода Chromium.
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/ru/mozilla/add-ons/webextensions/api/cookies/index.md b/files/ru/mozilla/add-ons/webextensions/api/cookies/index.md
index 3c9f65109bb848..a0b817e8ba5665 100644
--- a/files/ru/mozilla/add-ons/webextensions/api/cookies/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/api/cookies/index.md
@@ -77,7 +77,8 @@ In order to use this API, an add-on must specify the "cookies" [API permission](
 
 {{WebExtExamples("h2")}}
 
-> **Примечание:** Это API основано на API Chromium [`chrome.cookies`](https://developer.chrome.com/extensions/cookies). Эта документация основана на [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) из кода Chromium.
+> [!NOTE]
+> Этот API основан на Chromium API [`chrome.cookies`](https://developer.chrome.com/extensions/cookies). Эта документация основана на [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) из кода Chromium.
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/ru/mozilla/add-ons/webextensions/api/downloads/index.md b/files/ru/mozilla/add-ons/webextensions/api/downloads/index.md
index 6981e78e17930b..819809e31b6515 100644
--- a/files/ru/mozilla/add-ons/webextensions/api/downloads/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/api/downloads/index.md
@@ -78,7 +78,8 @@ slug: Mozilla/Add-ons/WebExtensions/API/downloads
 
 {{WebExtExamples("h2")}}
 
-> **Примечание:** Это API основано на API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads).
+> [!NOTE]
+> Этот API основан на Chromium API [`chrome.downloads`](https://developer.chrome.com/extensions/downloads).
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/ru/mozilla/add-ons/webextensions/api/runtime/getmanifest/index.md b/files/ru/mozilla/add-ons/webextensions/api/runtime/getmanifest/index.md
index 262e5fa49f55e7..5fd76ed840f41c 100644
--- a/files/ru/mozilla/add-ons/webextensions/api/runtime/getmanifest/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/api/runtime/getmanifest/index.md
@@ -36,7 +36,8 @@ console.log(manifest.name);
 
 {{WebExtExamples}}
 
-> **Примечание:** Это API основано на API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime). Эта документация основана на [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) из кода Chromium.
+> [!NOTE]
+> Этот API основан на Chromium API [`chrome.runtime`](https://developer.chrome.com/extensions/runtime). Эта документация основана на [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) из кода Chromium.
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/ru/mozilla/add-ons/webextensions/api/tabs/get/index.md b/files/ru/mozilla/add-ons/webextensions/api/tabs/get/index.md
index 45429ee41de056..2ac6105a7f8a8a 100644
--- a/files/ru/mozilla/add-ons/webextensions/api/tabs/get/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/api/tabs/get/index.md
@@ -35,7 +35,8 @@ browser.tabs.get(
 
 {{WebExtExamples}}
 
-> **Примечание:** Этот API основан на Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-get) API. Это документация получена из [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json) в коде Chromium.
+> [!NOTE]
+> Этот API основан на Chromium API [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-get) API. Это документация получена из [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json) в коде Chromium.
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/ru/mozilla/add-ons/webextensions/api/webrequest/index.md b/files/ru/mozilla/add-ons/webextensions/api/webrequest/index.md
index 7438c6f1ed7e64..fab6c25df7e995 100644
--- a/files/ru/mozilla/add-ons/webextensions/api/webrequest/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/api/webrequest/index.md
@@ -126,7 +126,8 @@ slug: Mozilla/Add-ons/WebExtensions/API/webRequest
 
 {{WebExtExamples("h2")}}
 
-> **Примечание:** Это API основано на API Chromium [`chrome.webRequest`](https://developer.chrome.com/extensions/webRequest). Эта документация основана на [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) из кода Chromium.
+> [!NOTE]
+> Этот API основан на Chromium API [`chrome.webRequest`](https://developer.chrome.com/extensions/webRequest). Эта документация основана на [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) из кода Chromium.
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/ru/mozilla/add-ons/webextensions/api/windows/createtype/index.md b/files/ru/mozilla/add-ons/webextensions/api/windows/createtype/index.md
index 31a1a71f2a42aa..6f9e08611f7276 100644
--- a/files/ru/mozilla/add-ons/webextensions/api/windows/createtype/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/api/windows/createtype/index.md
@@ -22,7 +22,8 @@ slug: Mozilla/Add-ons/WebExtensions/API/windows/CreateType
 
 {{WebExtExamples}}
 
-> **Примечание:** Это API основано на API Chromium [`chrome.windows`](https://developer.chrome.com/extensions/windows#type-CreateType). Эта документация основана на [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) из кода Chromium.
+> [!NOTE]
+> Этот API основан на Chromium API [`chrome.windows`](https://developer.chrome.com/extensions/windows#type-CreateType). Эта документация основана на [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) из кода Chromium.
 >
 > Информация о совместимости Microsoft Edge предоставлена корпорацией Microsoft и включена здесь под лицензией Creative Commons Attribution 3.0 United States License.
 
diff --git a/files/ru/mozilla/add-ons/webextensions/api/windows/index.md b/files/ru/mozilla/add-ons/webextensions/api/windows/index.md
index 9976166ebeacdd..98aff59c8e235f 100644
--- a/files/ru/mozilla/add-ons/webextensions/api/windows/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/api/windows/index.md
@@ -57,7 +57,8 @@ slug: Mozilla/Add-ons/WebExtensions/API/windows
 
 {{WebExtExamples("h2")}}
 
-> **Примечание:** Это API основано на API Chromium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Эта документация основана на [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) из кода Chromium.
+> [!NOTE]
+> Этот API основан на Chromium API [`chrome.windows`](https://developer.chrome.com/extensions/windows). Эта документация основана на [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) из кода Chromium.
 >
 > Информация о совместимости Microsoft Edge предоставлена корпорацией Microsoft и включена здесь под лицензией Creative Commons Attribution 3.0 United States License.
 
diff --git a/files/ru/mozilla/add-ons/webextensions/chrome_incompatibilities/index.md b/files/ru/mozilla/add-ons/webextensions/chrome_incompatibilities/index.md
index a2f6456a109355..dbe3656a8fffc6 100644
--- a/files/ru/mozilla/add-ons/webextensions/chrome_incompatibilities/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/chrome_incompatibilities/index.md
@@ -7,12 +7,10 @@ slug: Mozilla/Add-ons/WebExtensions/Chrome_incompatibilities
 
 Веб расширения разработаны с поддержкой совместимости с расширениями Chrome и Оперы на сколько это возможно. Расширения, написанные для этих браузеров, должны работать в Firefox с минимальными изменениями.
 
-Всё же, Firefox на данный момент имеет поддержку только для ограниченного набора функций и API, поддержуемых в Chrome и Опере. Мы работаем над добавлением большей поддержки, но много функций пока ещё не поддерживаются и некоторые из них никогда не будут поддерживаться.
+Всё же, Firefox на данный момент имеет поддержку только для ограниченного набора функций и API, поддерживаемых в Chrome. Мы работаем над добавлением большей поддержки, но много функций пока ещё не поддерживаются и некоторые из них никогда не будут поддерживаться.
 
 Эта статья перечисляет все функции и API, которые полностью поддерживаются в Firefox Developer Edition (на данный момент Firefox 47). Там где функция поддерживается частично, мы указали на проблемные места.
 
-> **Примечание:** You should assume that features and APIs not listed here at all are not yet supported.
-
 ## manifest.json функция
 
 ### Полностью поддерживаемые ключи
diff --git a/files/ru/mozilla/add-ons/webextensions/content_scripts/index.md b/files/ru/mozilla/add-ons/webextensions/content_scripts/index.md
index 8715a5a290ceff..09fb6dfe51b53e 100644
--- a/files/ru/mozilla/add-ons/webextensions/content_scripts/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/content_scripts/index.md
@@ -13,29 +13,25 @@ slug: Mozilla/Add-ons/WebExtensions/Content_scripts
 
 Встраиваемые скрипты имеют доступ только к [небольшому подмножеству методов WebExtension API](/ru/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#%D0%92%D0%B7%D0%B0%D0%B8%D0%BC%D0%BE%D0%B4%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B5_%D1%81_%D1%84%D0%BE%D0%BD%D0%BE%D0%B2%D1%8B%D0%BC%D0%B8_%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D0%B0%D0%BC%D0%B8), но они могут [взаимодействовать с фоновыми скриптами](/ru/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#%D0%92%D0%B7%D0%B0%D0%B8%D0%BC%D0%BE%D0%B4%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B5_%D1%81_%D1%84%D0%BE%D0%BD%D0%BE%D0%B2%D1%8B%D0%BC%D0%B8_%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D0%B0%D0%BC%D0%B8), используя систему передачи сообщений, таким образом опосредовано имея доступ ко всему WebExtension API.
 
-> **Примечание:** Обратите внимание, что встраивание скриптов блокируется на следующих доменах:
->
-> - accounts-static.cdn.mozilla.net
-> - accounts.firefox.com
-> - addons.cdn.mozilla.net
-> - addons.mozilla.org
-> - api.accounts.firefox.com
-> - content.cdn.mozilla.net
-> - content.cdn.mozilla.net
-> - discovery.addons.mozilla.org
-> - input.mozilla.org
-> - install.mozilla.org
-> - oauth.accounts.firefox.com
-> - profile.accounts.firefox.com
-> - support.mozilla.org
-> - sync.services.mozilla.com
-> - testpilot.firefox.com
->
-> Если вы попытаетесь встроить скрипт на страницы, находящиеся на вышеперечисленных доменах, у вас ничего не выйдет, и веб-страница сделает запись о [CSP](/ru/docs/Web/HTTP/CSP) ошибке.
->
-> По причине того, что список запрещённых доменов включает в себя addons.mozilla.org, пользователи, которые попытаются испытать ваше расширение прямо на странице загрузки, могут посчитать, что расширение не работает! В связи с этим вы могли бы предоставить им соответствующее предупреждение или [onboarding page](/ru/docs/Mozilla/Add-ons/WebExtensions/onboarding_upboarding_offboarding_best_practices) чтобы немедленно переадресовать их с addons.mozilla.org.
-
-> **Примечание:** Значения, определённые в глобальной области видимости встраиваемого скрипта с помощью `var foo` или `window.foo = "bar"` могут исчезать по причине бага [1408996](https://bugzilla.mozilla.org/show_bug.cgi?id=1408996).
+Обратите внимание, что встраивание скриптов блокируется на следующих доменах:
+
+- accounts-static.cdn.mozilla.net
+- accounts.firefox.com
+- addons.cdn.mozilla.net
+- addons.mozilla.org
+- api.accounts.firefox.com
+- content.cdn.mozilla.net
+- discovery.addons.mozilla.org
+- install.mozilla.org
+- oauth.accounts.firefox.com
+- profile.accounts.firefox.com
+- support.mozilla.org
+- sync.services.mozilla.com
+
+Если вы попытаетесь встроить скрипт на страницы, находящиеся на вышеперечисленных доменах, у вас ничего не выйдет, и веб-страница сделает запись о [CSP](/ru/docs/Web/HTTP/CSP) ошибке.
+
+> [!NOTE]
+> По причине того, что список запрещённых доменов включает в себя addons.mozilla.org, пользователи, которые попытаются испытать ваше расширение прямо на странице загрузки, могут посчитать, что расширение не работает! В связи с этим вы могли бы предоставить им соответствующее предупреждение или [onboarding page](https://extensionworkshop.com/documentation/develop/onboard-upboard-offboard-users/) чтобы немедленно переадресовать их с `addons.mozilla.org`.
 
 ## Загрузка встраиваемого скрипта
 
@@ -132,7 +128,8 @@ window.confirm("Вы уверены?"); // вызывает оригинальн
 ]
 ```
 
-> **Примечание:** Firefox предоставляет некоторое API, позволяющее встраиваемому скрипту иметь доступ к JavaScript объектам, созданным страничным скриптом, и предоставлять свои собственные JavaScript объекты страничному скрипту.
+> [!NOTE]
+> Firefox предоставляет некоторые API, позволяющие встраиваемому скрипту иметь доступ к JavaScript-объектам, созданным страничным скриптом, и предоставлять свои собственные JavaScript-объекты страничному скрипту.
 >
 > Смотрите [совместное использование объектов со страничным скриптом](/ru/docs/Mozilla/Add-ons/WebExtensions/Sharing_objects_with_page_scripts) для получения дополнительной информации.
 
@@ -171,7 +168,8 @@ window.confirm("Вы уверены?"); // вызывает оригинальн
 
 Встраиваемые скрипты могут делать запросы используя [`window.XMLHttpRequest`](/ru/docs/Web/API/XMLHttpRequest) и [`window.fetch()`](/ru/docs/Web/API/Fetch_API) API.
 
-> **Примечание:** В Firefox, запросы, совершаемые из встраиваемого скрипта (например, используя [fetch()](/ru/docs/Web/API/Fetch_API/Using_Fetch)) происходят в контексте расширения, так что вам необходимо предоставлять полный URL для доступа к контенту страниц. В Chrome, эти запросы совершаются в контексте страницы, так что URL может быть относительным, например `/api` будет трансформирован в `https://[current page URL]/api`.
+> [!NOTE]
+> В Firefox, запросы, совершаемые из встраиваемого скрипта (например, используя [fetch()](/ru/docs/Web/API/Fetch_API/Using_Fetch)) происходят в контексте расширения, так что вам необходимо предоставлять полный URL для доступа к контенту страниц. В Chrome, эти запросы совершаются в контексте страницы, так что URL может быть относительным, например `/api` будет трансформирован в `https://[current page URL]/api`.
 
 Встраиваемый скрипт имеет точно такие же кросс-доменные привилегии, как и всё остальное расширение: так что если расширение запросило кросс-доменный доступ на какой-либо домен используя [`permissions`](/ru/Add-ons/WebExtensions/manifest.json/permissions) ключ в manifest.json, тогда его встраиваемый скрипт тоже будет иметь доступ к этому домену.
 
@@ -371,7 +369,8 @@ window.addEventListener("message", function (event) {
 
 Для просмотра законченного и полностью рабочего примера, [посетите эту страницу на GitHub](https://mdn.github.io/webextensions-examples/content-script-page-script-messaging.html) и следуйте инструкциям.
 
-> **Предупреждение:** Заметьте, при взаимодействии с непроверенными страницами этим способом, вам нужно быть очень осторожными . Расширения имеют возможность запускать привилегированный код, который может обладать серьёзными возможностями, и вредоносные веб-страницы легко могут обмануть ваше расширение, ради доступа к этим возможностям.
+> [!WARNING]
+> Заметьте, при взаимодействии с непроверенными страницами этим способом, вам нужно быть очень осторожными . Расширения имеют возможность запускать привилегированный код, который может обладать серьёзными возможностями, и вредоносные веб-страницы легко могут обмануть ваше расширение, ради доступа к этим возможностям.
 >
 > Как простейший пример, представим встраиваемый скрипт, который получает сообщение от веб-страницы и делает что-то вроде этого:
 >
@@ -452,7 +451,8 @@ In page script, window.y: undefined
 
 Те же правила применимы к [`setTimeout()`](/ru/docs/Web/API/setTimeout), [`setInterval()`](/ru/docs/Web/API/setInterval), и [`Function()`](/ru/docs/Web/JavaScript/Reference/Global_Objects/Function).
 
-> **Предупреждение:** Будьте очень осторожны, запуская код в контексте страничного скрипта. Окружение страничного скрипта может контролироваться потенциально зловредным веб-страницей, которая может переопределить объекты, с которыми вы взаимодействуете, так что их поведение станет совершенно непредсказуемым:
+> [!WARNING]
+> Будьте очень осторожны, запуская код в контексте страничного скрипта. Окружение страничного скрипта может контролироваться потенциально зловредным веб-страницей, которая может переопределить объекты, с которыми вы взаимодействуете, так что их поведение станет совершенно непредсказуемым:
 >
 > ```js
 > // page.js переопределяет console.log
diff --git a/files/ru/mozilla/add-ons/webextensions/examples/index.md b/files/ru/mozilla/add-ons/webextensions/examples/index.md
index 8dadc6a0020d2d..c44bf712eb9117 100644
--- a/files/ru/mozilla/add-ons/webextensions/examples/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/examples/index.md
@@ -9,7 +9,8 @@ slug: Mozilla/Add-ons/WebExtensions/Examples
 
 Эти примеры работают в Firefox Nightly: большинство из них работает и в более ранних версиях Firefox, но, чтобы удостовериться, проверьте поле [strict_min_version](/en-US/Add-ons/WebExtensions/manifest.json/applications) в файле manifest.json.
 
-> **Предупреждение:** Некоторые примеры работают только на специальных доменах или страницах. Подробности о всех ограничениях представлены в файле readme каждого примера. По умолчанию ни один из примеров не работает в приватных окнах браузера, подробности смотрите в [Extensions in Private Browsing](https://support.mozilla.org/en-US/kb/extensions-private-browsing#w_enabling-or-disabling-extensions-in-private-windows).
+> [!WARNING]
+> Некоторые примеры работают только на специальных доменах или страницах. Подробности о всех ограничениях представлены в файле readme каждого примера. По умолчанию ни один из примеров не работает в приватных окнах браузера, подробности смотрите в [Extensions in Private Browsing](https://support.mozilla.org/en-US/kb/extensions-private-browsing#w_enabling-or-disabling-extensions-in-private-windows).
 
 Если вы хотите попробовать эти примеры, клонируйте репозиторий, а после этого совершите одно из следующих действий:
 
diff --git a/files/ru/mozilla/add-ons/webextensions/internationalization/index.md b/files/ru/mozilla/add-ons/webextensions/internationalization/index.md
index fd679ca9f8ae7f..2134cdd2a3a086 100644
--- a/files/ru/mozilla/add-ons/webextensions/internationalization/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/internationalization/index.md
@@ -7,7 +7,8 @@ slug: Mozilla/Add-ons/WebExtensions/Internationalization
 
 [WebExtensions](/ru/docs/Mozilla/Add-ons/WebExtensions) API предоставляет полезный модуль для интернационализации расширений — [i18n](/ru/docs/Mozilla/Add-ons/WebExtensions/API/i18n). В этой статье мы рассмотрим его особенности и пример его работы. Система для расширений, построенных с помощью WebExtension API, i18n похожа на библиотеки JavaScript для i18n, такие как [i18n.js](http://i18njs.com/).
 
-> **Примечание:** Расширение, используемое в этой статье в качестве примера, — [notify-link-clicks-i18n](https://github.com/mdn/webextensions-examples/tree/master/notify-link-clicks-i18n) — доступно на GitHub. Читая последующие секции этой статьи, вы можете исследовать его исходный код.
+> [!NOTE]
+> Расширение, используемое в этой статье в качестве примера, — [notify-link-clicks-i18n](https://github.com/mdn/webextensions-examples/tree/master/notify-link-clicks-i18n) — доступно на GitHub. Читая последующие секции этой статьи, вы можете исследовать его исходный код.
 
 ## Структура интернализированного расширения
 
@@ -89,7 +90,8 @@ slug: Mozilla/Add-ons/WebExtensions/Internationalization
 
 Это стандартный файл JSON — каждый из его элементов является объектом с именем, содержащим сообщение (`message)` и описание (`description)`. Оба предмета - строки; `$URL$` — это заполнитель, который заменяется подстрокой, когда элемент `notificationContent` вызывается расширением. Вы научитесь это делать в секции [Получение сообщений из JavaScript](#получение_сообщений_из_javascript).
 
-> **Примечание:** вы можете найти больше информации о структуре `messages.json` [здесь](/ru/docs/Mozilla/Add-ons/WebExtensions/API/i18n/Locale-Specific_Message_reference).
+> [!NOTE]
+> Больше информации о структуре `messages.json` можно найти в [справочнике](/ru/docs/Mozilla/Add-ons/WebExtensions/API/i18n/Locale-Specific_Message_reference).
 
 ## Интернационализация manifest.json
 
@@ -337,13 +339,7 @@ padding-left: 1.5em;
 4. Найдите `intl.locale.matchOS` и, если параметр существует и равен `true`, дважды нажмите на него и установите на `false`.
 5. Перезапустите браузер, чтобы изменения вступили в силу.
 
-> **Примечание:** Этот метод работает, даже если у вас не установлен [языковой пакет](https://addons.mozilla.org/en-US/firefox/language-tools/) для выбранного языка. В этом случае UI браузера просто будет использовать ваш язык по умолчанию.
-
-> **Примечание:** Чтобы изменить результат `getUILanguage` требуется языковой пакет, поскольку он отражает язык UI браузера, а не язык сообщений расширения.
-
 Ещё раз загрузите расширение с диска и протестируйте локализацию:
 
 - Ещё раз откройте "about:addons" — теперь вы должны увидеть ваше расширение, его иконку, имя и описание на выбранном языке.
 - Ещё раз протестируйте расширение. Для нашего примера, вам следовало бы посетить другую страницу и, нажав на ссылку, проверить, появляется ли сообщение на нужном языке.
-
-{{EmbedYouTube("R7--fp5pPGg")}}
diff --git a/files/ru/mozilla/add-ons/webextensions/manifest.json/icons/index.md b/files/ru/mozilla/add-ons/webextensions/manifest.json/icons/index.md
index fd205e20c346c1..639c6144024e41 100644
--- a/files/ru/mozilla/add-ons/webextensions/manifest.json/icons/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/manifest.json/icons/index.md
@@ -67,7 +67,8 @@ Firefox учитывает разрешение экрана, когда выб
    }
    ```
 
-> **Примечание:** Если вы используете программу Inkscape или подобную ей для создания SVG, сохраняйте изображение как "Простой SVG". Иначе Firefox может запутаться во множестве специальных пространств имён и не отобразить картинку.
+> [!NOTE]
+> Если вы используете программу Inkscape или подобную ей для создания SVG, сохраняйте изображение как "Простой SVG". Иначе Firefox может запутаться во множестве специальных пространств имён и не отобразить картинку.
 
 ## Совместимость с браузерами
 
diff --git a/files/ru/mozilla/add-ons/webextensions/manifest.json/index.md b/files/ru/mozilla/add-ons/webextensions/manifest.json/index.md
index a4b6cef1480fa0..2e3fd8510eaf2c 100644
--- a/files/ru/mozilla/add-ons/webextensions/manifest.json/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/manifest.json/index.md
@@ -5,7 +5,8 @@ slug: Mozilla/Add-ons/WebExtensions/manifest.json
 
 {{AddonSidebar}}
 
-> **Примечание:** В этой статье описан файл manifest.json для веб-расширений. Если вы ищете информацию о manifest.json для Прогрессивных веб-приложений (PWAs), смотрите статью [Манифест веб-приложения](/ru/docs/Web/Manifest).
+> [!NOTE]
+> В этой статье описан файл `manifest.json` для веб-расширений. Если вы ищете информацию о `manifest.json` для прогрессивных веб-приложений (PWA), смотрите статью [Манифест веб-приложения](/ru/docs/Web/Manifest).
 
 Файл `manifest.json` это единственный файл, который обязательно должен быть в каждом расширении, использующем WebExtension API.
 
@@ -37,7 +38,8 @@ browser.runtime.getManifest().version;
 
 В следующем блоке показан основной синтаксис некоторых часто используемых полей манифеста.
 
-> **Примечание:** Этот пример не рассчитан для того, чтобы его скопировали и вставили в файл реального проекта. Выбор нужных полей зависит от особенностей создаваемого расширения.
+> [!NOTE]
+> Этот пример не рассчитан для того, чтобы его скопировали и вставили в файл реального проекта. Выбор нужных полей зависит от особенностей создаваемого расширения.
 
 Если нужны примеры готовых расширений, смотрите [Примеры расширений](/ru/docs/Mozilla/Add-ons/WebExtensions/Examples).
 
diff --git a/files/ru/mozilla/add-ons/webextensions/match_patterns/index.md b/files/ru/mozilla/add-ons/webextensions/match_patterns/index.md
index 98b2dd179bcddc..882b372f410e4d 100644
--- a/files/ru/mozilla/add-ons/webextensions/match_patterns/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/match_patterns/index.md
@@ -11,8 +11,9 @@ API, которое использует шаблоны совпадения, о
 
 ## Структура шаблона совпадения
 
-> **Примечание:** Некоторые браузеры не поддерживают определённые схемы.
-> Смотрите [Browser compatibility table](#Browser_compatibility) для дополнительной информации.
+> [!NOTE]
+> Некоторые браузеры не поддерживают определённые схемы.
+> Смотрите [таблицу совместимости с браузерами](#совместимость_с_браузерами) для дополнительной информации.
 
 Все шаблоны совпадения объявляются в виде строк. За исключением специального [`<all_urls>`](/ru/Add-ons/WebExtensions/Match_patterns#%3Call_urls%3E) шаблона, шаблоны совпадения состоят из трёх компонентов: _схема_, _хост_ и _путь_. Схема и хост разделяются с помощью `://`.
 
diff --git a/files/ru/mozilla/add-ons/webextensions/modify_a_web_page/index.md b/files/ru/mozilla/add-ons/webextensions/modify_a_web_page/index.md
index 17093f457d348d..6c948cef1efe5a 100644
--- a/files/ru/mozilla/add-ons/webextensions/modify_a_web_page/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/modify_a_web_page/index.md
@@ -41,9 +41,11 @@ slug: Mozilla/Add-ons/WebExtensions/Modify_a_web_page
 
 Ключ [`content_scripts`](/ru/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts) - это как мы загружаем скрипты на страницы, соответствующие URL-шаблону. В нашем случае, `content_scripts` говорит браузеру загрузить скрипт "page-eater.js" на все страницы, начинающиеся с <https://developer.mozilla.org/>.
 
-> **Примечание:** Поскольку свойство `"js"` ключа `content_scripts` это массив, вы можете использовать его, для внедрения более одного скрипта. Если вы сделаете это, страницы получат набор, как если бы эти скрипты были загружены самой страницей, они будут загружены в той же очерёдности, в которой они расположены в массиве.
+> [!NOTE]
+> Поскольку свойство `"js"` ключа `content_scripts` это массив, вы можете использовать его, для внедрения более одного скрипта. Если вы сделаете это, страницы получат набор, как если бы эти скрипты были загружены самой страницей, они будут загружены в той же очерёдности, в которой они расположены в массиве.
 
-> **Примечание:** Ключ `content_scripts` также имеет свойство `"css"`, которое вы можете использовать для вставки CSS-таблиц.
+> [!NOTE]
+> Ключ `content_scripts` также имеет свойство `"css"`, которое вы можете использовать для вставки CSS-таблиц.
 
 Далее, создадим файл "page-eater.js", внутри директории "modify-page":
 
@@ -55,11 +57,9 @@ header.textContent = "Эта страница была съедена";
 document.body.appendChild(header);
 ```
 
-Теперь [установим расширение](/en-US/Add-ons/WebExtensions/Temporary_Installation_in_Firefox), и перейдём на страницу <https://developer.mozilla.org/>:
+Теперь [установим расширение](https://extensionworkshop.com/documentation/develop/temporary-installation-in-firefox) и перейдём на страницу [https://developer.mozilla.org/](/):
 
-{{EmbedYouTube("lxf2Tkg6U1M")}}
-
-> **Примечание:** Обратите внимание, несмотря на то, что в указанном видео, на странице [addons.mozilla.org](https://addons.mozilla.org/en-US/firefox/) всё работает нормально, на текущий момент, для этого сайта, контентные скрипты заблокированы.
+![страница developer.mozilla.org "съедена" скриптом](eaten_page.png)
 
 ## Программная модификация страницы
 
@@ -114,11 +114,9 @@ modify-page/
     page-eater.js
 ```
 
-Теперь [перезагрузим расширение](/en-US/Add-ons/WebExtensions/Temporary_Installation_in_Firefox#Reloading_a_temporary_add-on), откроем страницу (на этот раз любую) активируем контекстное меню и выберем "Съесть эту страницу":
-
-{{EmbedYouTube("zX4Bcv8VctA")}}
+Теперь [перезагрузим расширение](https://extensionworkshop.com/documentation/develop/temporary-installation-in-firefox/#reloading_a_temporary_add-on) откроем страницу (на этот раз любую), активируем контекстное меню и выберем "Съесть эту страницу":
 
-> **Примечание:** Обратите внимание, несмотря на то, что в указанном видео, на странице [addons.mozilla.org](https://addons.mozilla.org/en-US/firefox/) всё работает нормально, на текущий момент, для этого сайта, контентные скрипты заблокированы.
+![Пункт "Съесть страницу" в контекстном меню](eat_from_menu.png)
 
 ## Обмен сообщениями
 
@@ -180,7 +178,8 @@ browser.runtime.onMessage.addListener(eatPage);
 
 Если мы хотим отправить сообщение наоборот, из контентного скрипта в фоновый, настройка будет обратной данному примеру, за исключением того, что мы будем использовать [`runtime.sendMessage()`](/ru/docs/Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage) в контентном скрипте.
 
-> **Примечание:** Все эти примеры внедряют JavaScript; вы можете программно внедрять стилевые таблицы CSS используя функцию [`tabs.insertCSS()`](/ru/docs/Mozilla/Add-ons/WebExtensions/API/tabs/insertCSS).
+> [!NOTE]
+> Все эти примеры внедряют JavaScript; вы можете программно внедрять стилевые таблицы CSS используя функцию [`tabs.insertCSS()`](/ru/docs/Mozilla/Add-ons/WebExtensions/API/tabs/insertCSS).
 
 ## Узнать больше
 
diff --git a/files/ru/mozilla/add-ons/webextensions/user_interface/index.md b/files/ru/mozilla/add-ons/webextensions/user_interface/index.md
index deb7caa995a062..6f20d0ce38d3c5 100644
--- a/files/ru/mozilla/add-ons/webextensions/user_interface/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/user_interface/index.md
@@ -7,7 +7,8 @@ slug: Mozilla/Add-ons/WebExtensions/user_interface
 
 У расширений есть несколько органов взаимодействия с пользователем, с их помощью человек пользуется _расширенной_ функциональностью. Все они перечислены ниже, с инструкцией как использовать в своём расширении каждый из них.
 
-> **Примечание:** Советы как с помощью этих элементов пользовательского интерфейса (UI) обеспечить отличное взаимодействие человека с программой вы найдёте в статье [User experience best practices](/ru/docs/Mozilla/Add-ons/WebExtensions/User_experience_best_practices).
+> [!NOTE]
+> Советы как с помощью этих элементов пользовательского интерфейса (UI) обеспечить отличное взаимодействие человека с программой вы найдёте в статье [User experience best practices](/ru/docs/Mozilla/Add-ons/WebExtensions/User_experience_best_practices).
 
 | Элемент UI                                                                                               | Назначение                                                                                                                                                                                                                                                  | Как выглядит?                                                                                                                                    |
 | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
diff --git a/files/ru/mozilla/add-ons/webextensions/your_first_webextension/index.md b/files/ru/mozilla/add-ons/webextensions/your_first_webextension/index.md
index aa36d34805d1f0..64d5394d1b7bee 100644
--- a/files/ru/mozilla/add-ons/webextensions/your_first_webextension/index.md
+++ b/files/ru/mozilla/add-ons/webextensions/your_first_webextension/index.md
@@ -7,7 +7,8 @@ l10n:
 
 {{AddonSidebar}}
 
-> **Примечание:** Если вы уже знакомы с основными понятиями о браузерных расширениях, то можете пропустить этот раздел и [узнать как собираются файлы расширений](/ru/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension). Также вы можете использовать [справочную документацию](/ru/docs/Mozilla/Add-ons/WebExtensions#reference) чтобы начать создавать свои расширения. Посетите [Мастер-класс по расширениям Firefox](https://extensionworkshop.com/?utm_source=developer.mozilla.org&utm_medium=documentation&utm_campaign=your-first-extension) чтобы узнать больше о тестировании и публикации расширений для Firefox
+> [!NOTE]
+> Если вы уже знакомы с основными понятиями о браузерных расширениях, то можете пропустить этот раздел и [узнать как собираются файлы расширений](/ru/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension). Также вы можете использовать [справочную документацию](/ru/docs/Mozilla/Add-ons/WebExtensions#reference) чтобы начать создавать свои расширения. Посетите [Мастер-класс по расширениям Firefox](https://extensionworkshop.com/?utm_source=developer.mozilla.org&utm_medium=documentation&utm_campaign=your-first-extension) чтобы узнать больше о тестировании и публикации расширений для Firefox
 
 В этой статье мы пройдём весь путь создания расширения для Firefox от начала и до конца. Это расширение будет просто добавлять красную рамку ко всем страницам, загруженным с `mozilla.org` или любого из его поддоменов.
 
@@ -118,13 +119,15 @@ borderify/
 
 ### Тестирование
 
-> **Примечание:** По умолчанию [расширения не работают в режиме приватного просмотра](https://support.mozilla.org/ru/kb/dopolneniya-v-rezhime-privatnogo-prosmotra). Если вы хотите протестировать расширение в режиме приватного просмотра, то откройте `about:addons`, выберите расширение и установите переключатель `Запуск в приватных окнах` в положение `Разрешить`.
+> [!NOTE]
+> По умолчанию [расширения не работают в режиме приватного просмотра](https://support.mozilla.org/ru/kb/dopolneniya-v-rezhime-privatnogo-prosmotra). Если вы хотите протестировать расширение в режиме приватного просмотра, то откройте `about:addons`, выберите расширение и установите переключатель `Запуск в приватных окнах` в положение `Разрешить`.
 
 Теперь перейдите на любую страницу "`https://www.mozilla.org/ru/`" и вы должны будете увидеть красную границу вокруг страницы.
 
 ![На mozilla.org отображается рамка](border_on_mozilla_org.png)
 
-> **Примечание:** Не проверяйте на `addons.mozilla.org`! Встраиваемые скрипты на данный момент запрещены на этом поддомене.
+> [!NOTE]
+> Не проверяйте на `addons.mozilla.org`! Встраиваемые скрипты на данный момент запрещены на этом поддомене.
 
 Попробуйте немного поэкспериментировать. Измените цвет границы или сделайте что-нибудь ещё с содержимым страницы. Для этого внесите изменения в скрипт и перезагрузите файлы расширения, нажав кнопку `Обновить` в `about:debugging`. Сразу после этого изменения станут видны.
 
diff --git a/files/ru/mozilla/firefox/releases/68/index.md b/files/ru/mozilla/firefox/releases/68/index.md
index 7103ab81ca5c77..2b17f4476208ea 100644
--- a/files/ru/mozilla/firefox/releases/68/index.md
+++ b/files/ru/mozilla/firefox/releases/68/index.md
@@ -144,7 +144,8 @@ _Без изменений._
 - Конструктор {{domxref("MediaStreamAudioSourceNode.MediaStreamAudioSourceNode", "MediaStreamAudioSourceNode()")}} был обновлён в соответствии со спецификацией, где "first audio track" в потоке дорожка, идентификатора которой приходит первым в лексикографическом порядке ([Firefox bug 1324548](https://bugzil.la/1324548)).
 - {{domxref("MediaDevices.getUserMedia", "getUserMedia()")}} больше не может быть использован из небезопасного контекста; попытки сделать это будут сопровождаться исключением `NotAllowedError`. Безопасными контекстами считаются те, которые загруженные через HTTPS, либо которые использую схему `file:///`, либо загружены из `localhost`. Сейчас, если необходимо, вы можете включить возможность совершать небезопасные вызовы `getUserMedia()`, установив надстройку `media.getusermedia.insecure.enabled` в состояние `true` ([Firefox bug 1335740](https://bugzil.la/1335740)).
 
-  > **Примечание:** В будущем, Firefox также удалит свойство {{domxref("navigator.mediaDevices")}} на незащищённых контекстах, предотвратив доступ к {{domxref("MediaDevices")}} API. **Это уже так в Nightly сборках.**
+  > [!NOTE]
+  > В будущем, Firefox также удалит свойство {{domxref("navigator.mediaDevices")}} на незащищённых контекстах, предотвратив доступ к {{domxref("MediaDevices")}} API. **Это уже так в Nightly сборках.**
 
 #### Удалённые