Merge remote-tracking branch 'origin/main' into sidebar-a11y

.github/workflows/argos.yml

@@ -27,7 +27,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out repository code
-        uses: actions/checkout@v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
         with:
           # A minimal fetch-depth of 2 is required
           # to automatically detect branch in @argos-ci/cli
@@ -42,7 +42,7 @@ jobs:
         run: yarn install --frozen-lockfile
 
       - name: Install Playwright browsers
-        run: npx playwright install --with-deps
+        run: npx playwright install --with-deps chromium
 
       - name: Build website fast
         run: yarn build:website:fast

.github/workflows/build-blog-only.yml

@@ -22,7 +22,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
       - name: Set up Node
         uses: actions/setup-node@64ed1c7eab4cce3362f8c340dee64e5eaeef8f7c # v3
         with:

.github/workflows/build-perf.yml

@@ -36,7 +36,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
       - name: Set up Node
         uses: actions/setup-node@64ed1c7eab4cce3362f8c340dee64e5eaeef8f7c # v3
         with:
@@ -57,7 +57,7 @@ jobs:
     timeout-minutes: 30
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+      - uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
       - uses: actions/setup-node@64ed1c7eab4cce3362f8c340dee64e5eaeef8f7c # v3
         with:
           cache: yarn

.github/workflows/canary-release.yml

@@ -17,7 +17,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
         with:
           fetch-depth: 0 # Needed to get the commit number with "git rev-list --count HEAD"
       - name: Set up Node

.github/workflows/codeql-analysis.yml

@@ -33,7 +33,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
 
       - name: Initialize CodeQL
         uses: github/codeql-action/init@cdcdbb579706841c47f7063dda365e292e5cad7a # 2.13.4

.github/workflows/dependency-review.yml

@@ -13,6 +13,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab #v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
       - name: Dependency Review
-        uses: actions/dependency-review-action@f6fff72a3217f580d5afd49a46826795305b63c7 # 3.0.8
+        uses: actions/dependency-review-action@6c5ccdad469c9f8a2996bfecaec55a631a347034 # 3.1.0

.github/workflows/lighthouse-report.yml

@@ -21,7 +21,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
       - name: Wait for the Netlify Preview
         uses: jakepartusch/wait-for-netlify-action@f1e137043864b9ab9034ae3a5adc1c108e3f1a48 # v1
         id: netlify

.github/workflows/lint.yml

@@ -20,7 +20,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
       - name: Set up Node
         uses: actions/setup-node@64ed1c7eab4cce3362f8c340dee64e5eaeef8f7c # v3
         with:

.github/workflows/showcase-test.yml

@@ -22,7 +22,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
       - name: Set up Node
         uses: actions/setup-node@64ed1c7eab4cce3362f8c340dee64e5eaeef8f7c # v3
         with:

.github/workflows/tests-e2e.yml

@@ -41,7 +41,7 @@ jobs:
         node: ['16.14', '16', '18']
     steps:
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
       - name: Use Node.js ${{ matrix.node }}
         uses: actions/setup-node@64ed1c7eab4cce3362f8c340dee64e5eaeef8f7c # v3
         with:
@@ -75,7 +75,7 @@ jobs:
         variant: [-s, -st]
     steps:
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
       - name: Use Node.js 16
         uses: actions/setup-node@64ed1c7eab4cce3362f8c340dee64e5eaeef8f7c # v3
         with:
@@ -129,7 +129,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
       - name: Use Node.js 16
         uses: actions/setup-node@64ed1c7eab4cce3362f8c340dee64e5eaeef8f7c # v3
         with:
@@ -159,7 +159,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
       - name: Use Node.js 16
         uses: actions/setup-node@64ed1c7eab4cce3362f8c340dee64e5eaeef8f7c # v3
         with:

.github/workflows/tests-swizzle.yml

@@ -26,7 +26,7 @@ jobs:
         variant: ['js', 'ts']
     steps:
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
       - name: Set up Node
         uses: actions/setup-node@64ed1c7eab4cce3362f8c340dee64e5eaeef8f7c # v3
         with:

.github/workflows/tests-windows.yml

@@ -31,7 +31,7 @@ jobs:
       - name: Support longpaths
         run: git config --system core.longpaths true
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
       - name: Use Node.js ${{ matrix.node }}
         uses: actions/setup-node@64ed1c7eab4cce3362f8c340dee64e5eaeef8f7c # v3
         with:

.github/workflows/tests.yml

@@ -29,7 +29,7 @@ jobs:
         node: ['16.14', '16', '18']
     steps:
       - name: Checkout
-        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3
+        uses: actions/checkout@3df4ab11eba7bda6032a0b82a6bb43b11571feac # v4.0.0
       - name: Use Node.js ${{ matrix.node }}
         uses: actions/setup-node@64ed1c7eab4cce3362f8c340dee64e5eaeef8f7c # v3
         with:

argos/tests/screenshot.css

@@ -6,14 +6,22 @@
  */
 
 /*
-Hide some things in Argos screenshots because they are a source of flakiness
+We need to hide some elements in Argos/Playwright screenshots
+Those elements are source of flakiness due to nondeterministic rendering
+They don't consistently render exactly the same across CI runs
  */
+
+/******* DOCUSAURUS GLOBAL / THEME *******/
+
+/* Iframes can load lazily */
 iframe,
-article.yt-lite,
+/* Avatar images can be flaky due to using external sources: GitHub/Unavatar */
 .avatar__photo,
+/* Gifs load lazily and are animated */
 img[src$='.gif'],
-h2#using-jsx-markup ~ div > div[class*='browserWindowBody']:has(b),
+/* Algolia Keyboard shortcuts appear with a little delay */
 .DocSearch-Button-Keys > kbd,
+/* The live playground preview can often display dates/counters */
 [class*='playgroundPreview'] {
   visibility: hidden;
 }
@@ -32,3 +40,15 @@ Mermaid diagrams are rendered client-side and produce layout shifts
 .docusaurus-mermaid-container {
   display: none;
 }
+
+/******* DOCUSAURUS WEBSITE SPECIFIC *******/
+
+/* ProductHunt vote counter can increment at any time */
+.producthunt-badge-widget {
+  visibility: hidden;
+}
+
+/* YouTube player lite can load video lazily */
+article.yt-lite {
+  visibility: hidden;
+}

packages/docusaurus-theme-common/package.json

@@ -44,7 +44,6 @@
     "parse-numeric-range": "^1.3.0",
     "prism-react-renderer": "^1.3.5",
     "tslib": "^2.6.0",
-    "use-sync-external-store": "^1.2.0",
     "utility-types": "^3.10.0"
   },
   "devDependencies": {

packages/docusaurus-theme-common/src/utils/historyUtils.ts

@@ -5,10 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import {useCallback, useEffect} from 'react';
+import {useCallback, useEffect, useSyncExternalStore} from 'react';
 import {useHistory} from '@docusaurus/router';
-// @ts-expect-error: TODO temporary until React 18 upgrade
-import {useSyncExternalStore} from 'use-sync-external-store/shim';
 import {useEvent} from './reactUtils';
 
 import type {History, Location, Action} from 'history';

packages/docusaurus-theme-common/src/utils/storageUtils.ts

@@ -5,9 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import {useCallback, useRef} from 'react';
-// @ts-expect-error: TODO temp error until React 18 upgrade
-import {useSyncExternalStore} from 'use-sync-external-store/shim';
+import {useCallback, useRef, useSyncExternalStore} from 'react';
 
 const StorageTypes = ['localStorage', 'sessionStorage', 'none'] as const;
 

packages/docusaurus-theme-translations/locales/es/plugin-ideal-image.json

@@ -1,7 +1,7 @@
 {
-  "theme.IdealImageMessage.404error": "404. Image not found",
-  "theme.IdealImageMessage.error": "Error. Click to reload",
-  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
-  "theme.IdealImageMessage.loading": "Loading...",
-  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+  "theme.IdealImageMessage.404error": "404. Imagen no encontrada",
+  "theme.IdealImageMessage.error": "Error. Click para recargar",
+  "theme.IdealImageMessage.load": "Click para recargar{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Cargando...",
+  "theme.IdealImageMessage.offline": "Tu navegador está desconectado. Image no cargada"
 }

packages/docusaurus-theme-translations/locales/es/theme-common.json

@@ -4,12 +4,12 @@
   "theme.CodeBlock.copied": "Copiado",
   "theme.CodeBlock.copy": "Copiar",
   "theme.CodeBlock.copyButtonAriaLabel": "Copiar código al portapapeles",
-  "theme.CodeBlock.wordWrapToggle": "Toggle word wrap",
+  "theme.CodeBlock.wordWrapToggle": "Alternar ajuste de palabras",
   "theme.DocSidebarItem.collapseCategoryAriaLabel": "Collapse sidebar category '{label}'",
   "theme.DocSidebarItem.expandCategoryAriaLabel": "Expand sidebar category '{label}'",
-  "theme.ErrorPageContent.title": "This page crashed.",
-  "theme.ErrorPageContent.tryAgain": "Try again",
-  "theme.NavBar.navAriaLabel": "Main",
+  "theme.ErrorPageContent.title": "Esta página ha fallado.",
+  "theme.ErrorPageContent.tryAgain": "Intente de nuevo",
+  "theme.NavBar.navAriaLabel": "Principal",
   "theme.NotFound.p1": "No pudimos encontrar lo que buscaba.",
   "theme.NotFound.p2": "Comuníquese con el dueño del sitio que lo vinculó a la URL original y hágale saber que su vínculo está roto.",
   "theme.NotFound.title": "Página No Encontrada",
@@ -29,29 +29,29 @@
   "theme.blog.post.paginator.olderPost": "Publicación más antigua",
   "theme.blog.post.plurals": "Una publicación|{count} publicaciones",
   "theme.blog.post.readMore": "Leer Más",
-  "theme.blog.post.readMoreLabel": "Read more about {title}",
+  "theme.blog.post.readMoreLabel": "Leer más acerca {title}",
   "theme.blog.post.readingTime.plurals": "Lectura de un minuto|{readingTime} min de lectura",
   "theme.blog.sidebar.navAriaLabel": "Navegación de publicaciones recientes",
   "theme.blog.tagTitle": "{nPosts} etiquetados con \"{tagName}\"",
-  "theme.colorToggle.ariaLabel": "Switch between dark and light mode (currently {mode})",
-  "theme.colorToggle.ariaLabel.mode.dark": "dark mode",
-  "theme.colorToggle.ariaLabel.mode.light": "light mode",
+  "theme.colorToggle.ariaLabel": "Cambiar entre modo oscuro y claro (actualmente {mode})",
+  "theme.colorToggle.ariaLabel.mode.dark": "modo oscuro",
+  "theme.colorToggle.ariaLabel.mode.light": "modo claro",
   "theme.common.editThisPage": "Editar esta página",
   "theme.common.headingLinkTitle": "Enlace directo al {heading}",
   "theme.common.skipToMainContent": "Saltar al contenido principal",
-  "theme.docs.DocCard.categoryDescription": "{count} items",
-  "theme.docs.breadcrumbs.home": "Home page",
+  "theme.docs.DocCard.categoryDescription": "{count} artículos",
+  "theme.docs.breadcrumbs.home": "Página de Inicio",
   "theme.docs.breadcrumbs.navAriaLabel": "Breadcrumbs",
   "theme.docs.paginator.navAriaLabel": "Página del documento",
   "theme.docs.paginator.next": "Siguiente",
   "theme.docs.paginator.previous": "Anterior",
-  "theme.docs.sidebar.closeSidebarButtonAriaLabel": "Close navigation bar",
+  "theme.docs.sidebar.closeSidebarButtonAriaLabel": "Cerrar barra de lateral",
   "theme.docs.sidebar.collapseButtonAriaLabel": "Colapsar barra lateral",
   "theme.docs.sidebar.collapseButtonTitle": "Colapsar barra lateral",
   "theme.docs.sidebar.expandButtonAriaLabel": "Expandir barra lateral",
   "theme.docs.sidebar.expandButtonTitle": "Expandir barra lateral",
-  "theme.docs.sidebar.navAriaLabel": "Docs sidebar",
-  "theme.docs.sidebar.toggleSidebarButtonAriaLabel": "Toggle navigation bar",
+  "theme.docs.sidebar.navAriaLabel": "Docs barra lateral",
+  "theme.docs.sidebar.toggleSidebarButtonAriaLabel": "Alternar barra lateral",
   "theme.docs.tagDocListPageTitle": "{nDocsTagged} con \"{tagName}\"",
   "theme.docs.tagDocListPageTitle.nDocsTagged": "Un documento etiquetado|{count} documentos etiquetados",
   "theme.docs.versionBadge.label": "Version: {versionLabel}",
@@ -62,12 +62,12 @@
   "theme.lastUpdated.atDate": " en {date}",
   "theme.lastUpdated.byUser": " por {user}",
   "theme.lastUpdated.lastUpdatedAtBy": "Última actualización{atDate}{byUser}",
-  "theme.navbar.mobileLanguageDropdown.label": "Languages",
+  "theme.navbar.mobileLanguageDropdown.label": "Lenguajes",
   "theme.navbar.mobileSidebarSecondaryMenu.backButtonLabel": "← Volver al menú principal",
   "theme.navbar.mobileVersionsDropdown.label": "Versiones",
   "theme.tags.tagsListLabel": "Etiquetas:",
   "theme.tags.tagsPageLink": "Ver Todas las Etiquetas",
   "theme.tags.tagsPageTitle": "Etiquetas",
-  "theme.unlistedContent.message": "This page is unlisted. Search engines will not index it, and only users having a direct link can access it.",
-  "theme.unlistedContent.title": "Unlisted page"
+  "theme.unlistedContent.message": "Esta página está sin clasificar. Los motores de búsqueda no la indexaran, y solo los usuarios con el enlace directo podrán acceder a esta.",
+  "theme.unlistedContent.title": "Página sin clasificar"
 }

packages/docusaurus-theme-translations/locales/es/theme-search-algolia.json

@@ -1,29 +1,29 @@
 {
   "theme.SearchBar.label": "Buscar",
-  "theme.SearchBar.seeAll": "See all {count} results",
-  "theme.SearchModal.errorScreen.helpText": "You might want to check your network connection.",
-  "theme.SearchModal.errorScreen.titleText": "Unable to fetch results",
-  "theme.SearchModal.footer.closeKeyAriaLabel": "Escape key",
-  "theme.SearchModal.footer.closeText": "to close",
-  "theme.SearchModal.footer.navigateDownKeyAriaLabel": "Arrow down",
-  "theme.SearchModal.footer.navigateText": "to navigate",
-  "theme.SearchModal.footer.navigateUpKeyAriaLabel": "Arrow up",
-  "theme.SearchModal.footer.searchByText": "Search by",
-  "theme.SearchModal.footer.selectKeyAriaLabel": "Enter key",
-  "theme.SearchModal.footer.selectText": "to select",
-  "theme.SearchModal.noResultsScreen.noResultsText": "No results for",
-  "theme.SearchModal.noResultsScreen.reportMissingResultsLinkText": "Let us know.",
-  "theme.SearchModal.noResultsScreen.reportMissingResultsText": "Believe this query should return results?",
-  "theme.SearchModal.noResultsScreen.suggestedQueryText": "Try searching for",
-  "theme.SearchModal.placeholder": "Search docs",
-  "theme.SearchModal.searchBox.cancelButtonText": "Cancel",
-  "theme.SearchModal.searchBox.resetButtonTitle": "Clear the query",
-  "theme.SearchModal.startScreen.favoriteSearchesTitle": "Favorite",
-  "theme.SearchModal.startScreen.noRecentSearchesText": "No recent searches",
-  "theme.SearchModal.startScreen.recentSearchesTitle": "Recent",
-  "theme.SearchModal.startScreen.removeFavoriteSearchButtonTitle": "Remove this search from favorites",
-  "theme.SearchModal.startScreen.removeRecentSearchButtonTitle": "Remove this search from history",
-  "theme.SearchModal.startScreen.saveRecentSearchButtonTitle": "Save this search",
+  "theme.SearchBar.seeAll": "Ver todos los {count} resultados",
+  "theme.SearchModal.errorScreen.helpText": "Quizás quieras comprobar tu conexión de red.",
+  "theme.SearchModal.errorScreen.titleText": "No se pueden obtener resultados",
+  "theme.SearchModal.footer.closeKeyAriaLabel": "tecla Escape",
+  "theme.SearchModal.footer.closeText": "cerrar",
+  "theme.SearchModal.footer.navigateDownKeyAriaLabel": "Flecha abajo",
+  "theme.SearchModal.footer.navigateText": "navegar",
+  "theme.SearchModal.footer.navigateUpKeyAriaLabel": "Flecha arriba",
+  "theme.SearchModal.footer.searchByText": "Buscar por",
+  "theme.SearchModal.footer.selectKeyAriaLabel": "tecla Enter",
+  "theme.SearchModal.footer.selectText": "seleccionar",
+  "theme.SearchModal.noResultsScreen.noResultsText": "Sin resultados para",
+  "theme.SearchModal.noResultsScreen.reportMissingResultsLinkText": "Háganos saber.",
+  "theme.SearchModal.noResultsScreen.reportMissingResultsText": "Creo que esta consulta debería devolver resultados?",
+  "theme.SearchModal.noResultsScreen.suggestedQueryText": "Intenta buscando por",
+  "theme.SearchModal.placeholder": "Buscar documentos",
+  "theme.SearchModal.searchBox.cancelButtonText": "Cancelar",
+  "theme.SearchModal.searchBox.resetButtonTitle": "Limpiar la búsqueda",
+  "theme.SearchModal.startScreen.favoriteSearchesTitle": "Favorito",
+  "theme.SearchModal.startScreen.noRecentSearchesText": "Sin búsquedas recientes",
+  "theme.SearchModal.startScreen.recentSearchesTitle": "Reciente",
+  "theme.SearchModal.startScreen.removeFavoriteSearchButtonTitle": "Eliminar esta búsqueda de favoritos",
+  "theme.SearchModal.startScreen.removeRecentSearchButtonTitle": "Eliminar esta búsqueda del historial",
+  "theme.SearchModal.startScreen.saveRecentSearchButtonTitle": "Guardar esta búsqueda",
   "theme.SearchPage.algoliaLabel": "Búsqueda por Algolia",
   "theme.SearchPage.documentsFound.plurals": "Un documento encontrado|{count} documentos encontrados",
   "theme.SearchPage.emptyResultsTitle": "Búsqueda en la documentación",

project-words.txt

@@ -419,3 +419,7 @@ hastscript
 Flightcontrol
 Fargate
 Flightcontrol's
+producthunt
+Gifs
+Iframes
+Unavatar

website/docs/guides/docs/docs-create-doc.mdx

@@ -56,7 +56,7 @@ Read more about [importing partial pages](../markdown-features/markdown-features
 
 ## Doc front matter {#doc-front-matter}
 
-The [front matter](../markdown-features/markdown-features-intro.mdx#front-matter) is used to provide additional metadata for your doc page. Front matter is optional—Docusaurus will be able to infer all necessary metadata without the front matter. For example, the [doc tags](#dog-tags) feature introduced below requires using front matter. For all possible fields, see [the API documentation](../../api/plugins/plugin-content-docs.mdx#markdown-front-matter).
+The [front matter](../markdown-features/markdown-features-intro.mdx#front-matter) is used to provide additional metadata for your doc page. Front matter is optional—Docusaurus will be able to infer all necessary metadata without the front matter. For example, the [doc tags](#doc-tags) feature introduced below requires using front matter. For all possible fields, see [the API documentation](../../api/plugins/plugin-content-docs.mdx#markdown-front-matter).
 
 ## Doc tags {#doc-tags}