Merge branch 'mdn:main' into feature/media_objects

docs/README.md

@@ -4,12 +4,12 @@ This document describes the general guidelines for translating MDN content, whic
 
 For guidelines relating to specific locales, we have locale-specific docs in subdirectories:
 
-- [Russian translation guide / Участие в переводе](ru/translation-guide.md)
-- [Simplified Chinese Guide / 简体中文翻译指南](zh-cn/translation-guide.md)
-- [Traditional Chinese Guide / 正體中文翻譯指南](zh-tw/translation-guide.md)
 - [Spanish guide / Guía en español](es/README.md)
 - [Japanese translation guide / 日本語翻訳ガイド](ja/README.md)
 - [Korean translation guide / 한국 번역 지침](ko/README.md)
+- [Russian translation guide / Руководство по переводу на русский язык](ru/README.md)
+- [Simplified Chinese Guide / 简体中文翻译指南](zh-cn/translation-guide.md)
+- [Traditional Chinese Guide / 正體中文翻譯指南](zh-tw/translation-guide.md)
 
 > [!NOTE]
 > If you want to add a guide to document some specific guidelines for your locale and it does not already appear here, you are welcome to add one, or [talk to the locale teams](https://github.com/mdn/translated-content/blob/main/PEERS_GUIDELINES.md#review-teams) about it.

docs/ru/translation-guide.md → docs/ru/README.md

@@ -1,10 +1,24 @@
 # Участие в переводе
 
-Для начала ознакомьтесь с [общими правилами][], в частности, со страницей ["Writing style guide"][].
+Для начала ознакомьтесь с [правилами внесения изменений в MDN][https://github.com/mdn/translated-content/blob/main/CONTRIBUTING.md], [информацией о переводе документов MDN](https://github.com/mdn/translated-content/blob/main/docs/README.md) и [Руководством по составлению документации](/ru/docs/MDN/Guidelines).
 
-Основная тема — [Перевод MDN на русский язык](https://github.com/mdn/translated-content/issues/276)
+## Использование ссылок
 
-## Рекомендации по переводу
+При переводе документов не забывайте изменять язык (`en-US` на `ru`) во внутренних ссылках на сайт MDN так, чтобы они вели на соответствующие локализованные страницы. Также для внутренних ссылок необходимо сохранять только путь в URL-адресе (без схемы и имени домена).
+
+Рассмотрим пример:
+
+```md
+If you are new to HTML, CSS, JavaScript, etc., try our [Learn web development](/en-US/docs/Learn) tutorials.
+```
+
+При переводе на русский язык следует заменить `en-US` на `ru`:
+
+```md
+Если вы только начинаете изучение HTML, CSS и JavaScript, попробуйте наши руководства по [Изучению веб-разработки](/ru/docs/Learn).
+```
+
+## Общие рекомендации по переводу на русский язык
 
 - «_Вы_» и его производные пишите с маленькой буквы.
 - Всегда используйте букву «`ё`».
@@ -15,7 +29,7 @@
 - При переводе зарубежных имён пользуйтесь [правилами практической транскрипции](https://ru.wikipedia.org/wiki/Категория:Практическая_транскрипция_с_русским_языком).
 - Не переводите названия компаний, библиотек и т.д.
 - Не переводите аббревиатуры (API, DOM, UI).
-- Не склоняйте через апостроф иностранные слова. Если это требуется, попробуйте русифицировать слово (URL'ы -> URL-адреса).
+- Не склоняйте через апостроф иностранные слова. Если это требуется, попробуйте русифицировать слово (например, вместо `URL'ы` следует использовать `URL-адреса`).
 - Названия статей и заголовки пишите с одной заглавной буквы.
 
 ## Глоссарий
@@ -37,6 +51,3 @@
 | technical reference | технические материалы (при использовании в качестве заголовка)       |
 
 \* — по возможности лучше избежать прямого перевода, используя синонимы или лучше раскрывая смысл.
-
-[общими правилами]: https://developer.mozilla.org/en-US/docs/MDN/Guidelines
-["Writing style guide"]: https://developer.mozilla.org/en-US/docs/MDN/Guidelines/Writing_style_guide

files/es/web/api/window/index.md

@@ -191,13 +191,13 @@ _Esta interfaz hereda metodos de la interfaz {{domxref("EventTarget")}} e implem
 - {{domxref("Window.confirm()")}}
   - : Muestra una ventana de comfirmación con dos únicas y posibles respuestas. **Confirmar** y **Cancelar**.
 - {{domxref("Window.disableExternalCapture()")}} {{deprecated_inline(24)}}
-  - : {{todo("NeedsContents")}}
+  - : <!-- TODO: add content -->
 - {{domxref("Window.dispatchEvent()")}}
   - : Usado para activar un evento.
 - {{domxref("Window.dump()")}}
   - : Escribe un mensaje a la consola.
 - {{domxref("Window.enableExternalCapture()")}} {{deprecated_inline(24)}}
-  - : {{todo("NeedsContents")}}
+  - : <!-- TODO: add content -->
 - {{domxref("Window.find()")}}
   - : Busca un string dado en una ventana.
 - {{domxref("Window.focus()")}}
@@ -207,7 +207,7 @@ _Esta interfaz hereda metodos de la interfaz {{domxref("EventTarget")}} e implem
 - {{domxref("Window.getAttention()")}}
   - : Flashes the application icon.
 - {{domxref("Window.getAttentionWithCycleCount()")}}
-  - : {{todo("NeedsContents")}}
+  - : <!-- TODO: add content -->
 - {{domxref("Window.getComputedStyle()")}}
   - : Gets computed style for the specified element. Computed style indicates the computed values of all CSS properties of the element.
 - {{domxref("Window.getDefaulComputedStyle()")}}
@@ -219,7 +219,7 @@ _Esta interfaz hereda metodos de la interfaz {{domxref("EventTarget")}} e implem
 - {{domxref("Window.matchMedia()")}}
   - : Returns a {{domxref("MediaQueryList")}} object representing the specified media query string.
 - {{domxref("Window.maximize()")}}
-  - : {{todo("NeedsContents")}}
+  - : <!-- TODO: add content -->
 - {{domxref("Window.minimize()")}} (top-level XUL windows only)
   - : Minimiza la ventana.
 - {{domxref("Window.moveBy()")}}
@@ -247,9 +247,9 @@ _Esta interfaz hereda metodos de la interfaz {{domxref("EventTarget")}} e implem
 - {{domxref("Window.resizeTo()")}}
   - : Dynamically resizes window.
 - {{domxref("Window.restore()")}}
-  - : {{todo("NeedsContents")}}
+  - : <!-- TODO: add content -->
 - {{domxref("Window.routeEvent()")}} {{deprecated_inline(24)}}
-  - : {{todo("NeedsContents")}}
+  - : <!-- TODO: add content -->
 - {{domxref("Window.scroll()")}}
   - : Scrolls the window to a particular place in the document.
 - {{domxref("Window.scrollBy()")}}
@@ -267,7 +267,7 @@ _Esta interfaz hereda metodos de la interfaz {{domxref("EventTarget")}} e implem
 - {{domxref("WindowTimers.setInterval()")}}
   - : Schedules the execution of a function each X milliseconds.
 - {{domxref("Window.setResizable")}}
-  - : {{todo("NeedsContents")}}
+  - : <!-- TODO: add content -->
 - {{domxref("WindowTimers.setTimeout()")}}
   - : Sets a delay for executing a function.
 - {{domxref("Window.showModalDialog()")}}
@@ -305,7 +305,7 @@ _Esta interfaz hereda controladores de eventos de la interfaz {{domxref("EventTa
 - {{domxref("Window.ondevicelight")}}
   - : An event handler property for any ambient light levels changes
 - {{domxref("Window.ondevicemotion")}}
-  - : {{todo("NeedsContents")}}
+  - : <!-- TODO: add content -->
 - {{domxref("Window.ondeviceorientation")}}
   - : An event handler property for any device orientation changes
 - {{domxref("Window.ondeviceproximity")}}

files/es/web/css/-webkit-mask-box-image/index.md

@@ -11,11 +11,11 @@ slug: Web/CSS/-webkit-mask-box-image
 
 `-webkit-mask-box-image` establece la imagen de máscara para la caja del borde de un elemento.
 
-- {{ Xref_cssinitial() }}: none
+- [Valor inicial](/es/docs/Web/CSS/initial_value): none
 - Se aplica a : Todos los elementos
-- {{ Xref_cssinherited() }}: no
+- [Heredable](/es/docs/Web/CSS/inheritance): no
 - Media: {{cssxref("Media/Visual", "visual")}}
-- {{ Xref_csscomputed() }}: tal y como se especfica
+- [Valor calculado](/es/docs/Web/CSS/computed_value): tal y como se especfica
 
 ## Síntaxis
 

files/es/web/css/-webkit-mask-composite/index.md

@@ -9,11 +9,11 @@ slug: Web/CSS/-webkit-mask-composite
 
 La propiedad `-webkit-mask-composite` especifica la forma en la que múltiples imágenes de máscara son compuestas para ser aplicadas al mismo elemento. Son compuestas en el orden en el que son declaradas en la propiedad {{ Cssxref("-webkit-mask-image") }}.
 
-- {{ Xref_cssinitial() }}: source-over
+- [Valor inicial](/es/docs/Web/CSS/initial_value): source-over
 - Se aplica a : todos los elementos
-- {{ Xref_cssinherited() }}: no
+- [Heredable](/es/docs/Web/CSS/inheritance): no
 - Media: {{cssxref("Media/Visual", "visual")}}
-- {{ Xref_csscomputed() }}: tal y como se especifica.
+- [Valor calculado](/es/docs/Web/CSS/computed_value): tal y como se especifica.
 
 ## Síntaxis
 

files/es/web/css/border-left-color/index.md

@@ -9,12 +9,12 @@ slug: Web/CSS/border-left-color
 
 `border-left-color` pone el color del borde izquierdo de un elemento,con el valor de el color en hexadecimal o con palabras clave, como azul, verde, rojo `transparente`.
 
-- {{ Xref_cssinitial() }}: {{ Cssxref("color") }} propiedad
+- [Valor inicial](/es/docs/Web/CSS/initial_value): {{ Cssxref("color") }} propiedad
 - Se aplica a : todos los elementos
-- {{ Xref_cssinherited() }}: no
+- [Heredable](/es/docs/Web/CSS/inheritance): no
 - Porcentajes: N/A
 - Media: {{cssxref("Media/Visual", "visual")}}
-- {{ Xref_csscomputed() }}: cuando son tomados de la propiedad 'color',los valores computarizados de 'color'; de otra manera como sean especificados.
+- [Valor calculado](/es/docs/Web/CSS/computed_value): cuando son tomados de la propiedad 'color',los valores computarizados de 'color'; de otra manera como sean especificados.
 
 ### Sintaxis