Create languages src directory (#41661)

Author: heiskr

.github/workflows/purge-fastly.yml

@@ -46,4 +46,4 @@ jobs:
         if: ${{ !inputs.nuke_all }}
         env:
           LANGUAGES: ${{ inputs.languages }}
-        run: .github/actions-scripts/purge-fastly-edge-cache-per-language.js
+        run: src/languages/scripts/purge-fastly-edge-cache-per-language.js

.github/workflows/test.yml

@@ -34,9 +34,9 @@ jobs:
         id: set-matrix
         with:
           script: |
-            // We only want to run the 'translations' suite when we know
+            // We only want to run the 'languages' suite when we know
             // we're on the private docs-internal repo because only that
-            // one has ability to clone the remote (private) translations
+            // one has ability to clone the remote (private) languages
             // repos.
             // You can run multiple paths per suite as space-separated in `path`.
             // Note that *if you add* to this, remember to also add that
@@ -64,7 +64,7 @@ jobs:
               { name: 'search', path: 'src/search/tests', },
               { name: 'shielding', path: 'src/shielding/tests', },
               context.payload.repository.full_name === 'github/docs-internal' &&
-                { name: 'translations', path: 'tests/translations', },
+                { name: 'languages', path: 'src/languages/tests', },
               { name: 'unit', path: 'tests/unit', },
               // { name: 'tools', path: 'src/tools/tests', }
               { name: 'webhooks', path: 'src/webhooks/tests', },
@@ -88,7 +88,7 @@ jobs:
         uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab
 
       - uses: ./.github/actions/setup-elasticsearch
-        if: ${{ matrix.name == 'search' || matrix.name == 'translations' }}
+        if: ${{ matrix.name == 'search' || matrix.name == 'languages' }}
 
       - uses: ./.github/actions/node-npm-setup
 
@@ -117,7 +117,7 @@ jobs:
             tests/fixtures/data
 
       - name: Clone all translations
-        if: ${{ matrix.name == 'translations' }}
+        if: ${{ matrix.name == 'languages' }}
         uses: ./.github/actions/clone-translations
         with:
           token: ${{ secrets.DOCS_BOT_PAT_READPUBLICKEY }}
@@ -169,7 +169,7 @@ jobs:
       - name: Index fixtures into the local Elasticsearch
         # For the sake of saving time, only run this step if the group
         # is one that will run tests against an Elasticsearch on localhost.
-        if: ${{ matrix.name == 'search' || matrix.name == 'translations' }}
+        if: ${{ matrix.name == 'search' || matrix.name == 'languages' }}
         run: npm run index-test-fixtures
 
       - name: Run tests
@@ -178,8 +178,8 @@ jobs:
           CHANGELOG_CACHE_FILE_PATH: tests/fixtures/changelog-feed.json
           # By default, when `process.env.NODE_ENV === 'test'` it forces the
           # tests run only in English. The exception is the
-          # `tests/translations/` suite which needs all languages to be set up.
-          ENABLED_LANGUAGES: ${{ matrix.name == 'translations' && 'all' || '' }}
+          # `languages` suite which needs all languages to be set up.
+          ENABLED_LANGUAGES: ${{ matrix.name == 'languages' && 'all' || '' }}
           ROOT: ${{ (matrix.name == 'rendering-fixtures' || matrix.name == 'pageinfo' || matrix.name == 'landings' ) && 'tests/fixtures' || '' }}
           TRANSLATIONS_FIXTURE_ROOT: ${{ (matrix.name == 'rendering-fixtures' || matrix.name == 'pageinfo') && 'tests/fixtures/translations' || '' }}
         run: npm test -- ${{ matrix.path }}/

components/DefaultLayout.tsx

@@ -9,7 +9,7 @@ import { SupportSection } from 'components/page-footer/SupportSection'
 import { DeprecationBanner } from 'components/page-header/DeprecationBanner'
 import { RestBanner } from 'src/rest/components/RestBanner'
 import { useMainContext } from 'components/context/MainContext'
-import { useTranslation } from 'components/hooks/useTranslation'
+import { useTranslation } from 'src/languages/components/useTranslation'
 import { Breadcrumbs } from 'components/page-header/Breadcrumbs'
 
 const MINIMAL_RENDER = Boolean(JSON.parse(process.env.MINIMAL_RENDER || 'false'))

components/article/ArticlePage.tsx

@@ -20,7 +20,7 @@ import { LearningTrackCard } from 'src/learning-track/components/article/Learnin
 import { RestRedirect } from 'src/rest/components/RestRedirect'
 import { Breadcrumbs } from 'components/page-header/Breadcrumbs'
 import { Link } from 'components/Link'
-import { useTranslation } from 'components/hooks/useTranslation'
+import { useTranslation } from 'src/languages/components/useTranslation'
 import { LinkPreviewPopover } from 'components/LinkPreviewPopover'
 
 const ClientSideRefresh = dynamic(() => import('components/ClientSideRefresh'), {

components/page-footer/Contribution.tsx

@@ -1,7 +1,7 @@
 import { GitPullRequestIcon } from '@primer/octicons-react'
 
 import { useMainContext } from 'components/context/MainContext'
-import { useTranslation } from 'components/hooks/useTranslation'
+import { useTranslation } from 'src/languages/components/useTranslation'
 
 export const Contribution = () => {
   const { relativePath } = useMainContext()

components/page-footer/LegalFooter.tsx

@@ -2,7 +2,7 @@ import Link from 'next/link'
 import { useRouter } from 'next/router'
 import { LinkExternalIcon } from '@primer/octicons-react'
 import cx from 'classnames'
-import { useTranslation } from '../hooks/useTranslation'
+import { useTranslation } from 'src/languages/components/useTranslation'
 
 export const LegalFooter = () => {
   const router = useRouter()

components/page-footer/Support.tsx

@@ -1,6 +1,6 @@
 import { PeopleIcon, CommentDiscussionIcon } from '@primer/octicons-react'
 
-import { useTranslation } from 'components/hooks/useTranslation'
+import { useTranslation } from 'src/languages/components/useTranslation'
 import { useMainContext } from 'components/context/MainContext'
 
 export const Support = () => {

components/page-footer/SupportSection.tsx

@@ -6,7 +6,7 @@ import { Support } from 'components/page-footer/Support'
 import { useMainContext } from 'components/context/MainContext'
 import { useVersion } from 'components/hooks/useVersion'
 import { useRouter } from 'next/router'
-import { useTranslation } from '../hooks/useTranslation'
+import { useTranslation } from 'src/languages/components/useTranslation'
 
 export const SupportSection = () => {
   const { currentVersion } = useVersion()

components/page-header/Header.tsx

@@ -15,10 +15,10 @@ import { DEFAULT_VERSION, useVersion } from 'components/hooks/useVersion'
 import { Link } from 'components/Link'
 import { useMainContext } from 'components/context/MainContext'
 import { useHasAccount } from 'components/hooks/useHasAccount'
-import { LanguagePicker } from './LanguagePicker'
+import { LanguagePicker } from 'src/languages/components/LanguagePicker'
 import { HeaderNotifications } from 'components/page-header/HeaderNotifications'
 import { ApiVersionPicker } from 'src/rest/components/ApiVersionPicker'
-import { useTranslation } from 'components/hooks/useTranslation'
+import { useTranslation } from 'src/languages/components/useTranslation'
 import { Search } from 'src/search/components/Search'
 import { Breadcrumbs } from 'components/page-header/Breadcrumbs'
 import { VersionPicker } from 'components/page-header/VersionPicker'

components/page-header/HeaderNotifications.tsx

@@ -2,12 +2,12 @@ import { useRouter } from 'next/router'
 import cx from 'classnames'
 import { XIcon } from '@primer/octicons-react'
 
-import { useLanguages } from 'components/context/LanguagesContext'
+import { useLanguages } from 'src/languages/components/LanguagesContext'
 import { useMainContext } from 'components/context/MainContext'
-import { useTranslation } from 'components/hooks/useTranslation'
+import { useTranslation } from 'src/languages/components/useTranslation'
 import { ExcludesNull } from 'components/lib/ExcludesNull'
 import { useVersion } from 'components/hooks/useVersion'
-import { useUserLanguage } from 'components/hooks/useUserLanguage'
+import { useUserLanguage } from 'src/languages/components/useUserLanguage'
 import styles from './HeaderNotifications.module.scss'
 
 enum NotificationType {