From ff966068653fb2b2ebe221a3d79126c29d4ea56f Mon Sep 17 00:00:00 2001 From: Joshua Chen Date: Thu, 31 Mar 2022 20:23:44 +0800 Subject: [PATCH] docs: fix some casing inconsistencies (#7081) --- .github/workflows/build-perf.yml | 2 +- .github/workflows/tests-e2e.yml | 8 ++++---- CHANGELOG.md | 20 +++++++++---------- README.md | 2 +- admin/publish.md | 6 +++--- admin/testing-changes-on-Docusaurus-itself.md | 2 +- packages/create-docusaurus/src/index.ts | 10 +++++----- .../__fixtures__/simple-site/sidebars.json | 2 +- .../__tests__/__snapshots__/cli.test.ts.snap | 2 +- .../__snapshots__/index.test.ts.snap | 4 ++-- .../__fixtures__/sidebars/sidebars.json | 2 +- .../__snapshots__/index.test.ts.snap | 2 +- .../src/sidebars/__tests__/validation.test.ts | 4 ++-- .../src/__tests__/validateThemeConfig.test.ts | 2 +- packages/docusaurus-utils/src/pathUtils.ts | 4 ++-- .../2021-03-09-releasing-docusaurus-i18n.md | 2 +- .../2022-01-24-docusaurus-2021-recap/index.md | 4 ++-- website/docs/advanced/plugins.md | 2 +- website/docs/deployment.mdx | 2 +- website/docs/guides/creating-pages.md | 2 +- .../markdown-features-code-blocks.mdx | 2 +- .../markdown-features-plugins.mdx | 2 +- .../markdown-features-tabs.mdx | 16 +++++++-------- website/docs/i18n/i18n-crowdin.mdx | 4 ++-- website/docs/i18n/i18n-tutorial.md | 2 +- website/docs/typescript-support.md | 4 ++-- website/src/data/users.tsx | 8 ++++---- .../version-2.0.0-beta.17/advanced/plugins.md | 2 +- .../version-2.0.0-beta.17/deployment.mdx | 2 +- .../guides/creating-pages.md | 2 +- .../markdown-features-code-blocks.mdx | 2 +- .../markdown-features-plugins.mdx | 2 +- .../markdown-features-tabs.mdx | 16 +++++++-------- .../i18n/i18n-crowdin.mdx | 4 ++-- .../i18n/i18n-tutorial.md | 2 +- .../typescript-support.md | 4 ++-- .../version-2.0.0-beta.18/advanced/plugins.md | 2 +- .../version-2.0.0-beta.18/deployment.mdx | 2 +- .../guides/creating-pages.md | 2 +- .../markdown-features-code-blocks.mdx | 2 +- .../markdown-features-plugins.mdx | 2 +- .../markdown-features-tabs.mdx | 16 +++++++-------- .../i18n/i18n-crowdin.mdx | 4 ++-- .../i18n/i18n-tutorial.md | 2 +- .../typescript-support.md | 4 ++-- 45 files changed, 97 insertions(+), 97 deletions(-) diff --git a/.github/workflows/build-perf.yml b/.github/workflows/build-perf.yml index ad7b3c5c24..370d8a38c2 100644 --- a/.github/workflows/build-perf.yml +++ b/.github/workflows/build-perf.yml @@ -53,4 +53,4 @@ jobs: - name: Build (warm cache) run: yarn workspace website build --locale en timeout-minutes: 2 - # TODO post a Github comment with build with perf warnings? + # TODO post a GitHub comment with build with perf warnings? diff --git a/.github/workflows/tests-e2e.yml b/.github/workflows/tests-e2e.yml index 7bb9f842ff..dabc42f10d 100644 --- a/.github/workflows/tests-e2e.yml +++ b/.github/workflows/tests-e2e.yml @@ -100,7 +100,7 @@ jobs: working-directory: ../test-website npm: - name: E2E — NPM + name: E2E — npm timeout-minutes: 30 runs-on: ubuntu-latest steps: @@ -114,7 +114,7 @@ jobs: run: yarn - name: Generate test-website project against main branch run: yarn test:build:website -s - - name: Install test-website project with NPM + - name: Install test-website project with npm run: npm install working-directory: ../test-website env: @@ -129,7 +129,7 @@ jobs: working-directory: ../test-website pnpm: - name: E2E — PNPM + name: E2E — pnpm timeout-minutes: 30 runs-on: ubuntu-latest steps: @@ -143,7 +143,7 @@ jobs: run: yarn - name: Generate test-website project against main branch run: yarn test:build:website -s - - name: Install test-website project with PNPM + - name: Install test-website project with pnpm run: | curl -f https://get.pnpm.io/v6.16.js | node - add --global pnpm pnpm install diff --git a/CHANGELOG.md b/CHANGELOG.md index f30ba836d4..036b7aaa49 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -434,7 +434,7 @@ - [#6633](https://github.com/facebook/docusaurus/pull/6633) docs: improve wording of using Markdown file paths ([@BigDataWriter](https://github.com/BigDataWriter)) - [#6624](https://github.com/facebook/docusaurus/pull/6624) docs: add Resoto & Some Engineering Inc. to showcase ([@TheCatLady](https://github.com/TheCatLady)) - [#6611](https://github.com/facebook/docusaurus/pull/6611) docs: fix bad anchor link syntax ([@Josh-Cena](https://github.com/Josh-Cena)) - - [#6591](https://github.com/facebook/docusaurus/pull/6591) docs: improve Github Actions example jobs ([@ebarojas](https://github.com/ebarojas)) + - [#6591](https://github.com/facebook/docusaurus/pull/6591) docs: improve GitHub Actions example jobs ([@ebarojas](https://github.com/ebarojas)) - [#6426](https://github.com/facebook/docusaurus/pull/6426) feat(website): add Tweets section ([@yangshun](https://github.com/yangshun)) - [#6532](https://github.com/facebook/docusaurus/pull/6532) docs: add SAP Cloud SDK to showcase ([@artemkovalyov](https://github.com/artemkovalyov)) - [#6513](https://github.com/facebook/docusaurus/pull/6513) docs: clean up CONTRIBUTING ([@Josh-Cena](https://github.com/Josh-Cena)) @@ -932,7 +932,7 @@ - [#6123](https://github.com/facebook/docusaurus/pull/6123) test: use snapshots for sidebar tests ([@Josh-Cena](https://github.com/Josh-Cena)) - Other - [#6122](https://github.com/facebook/docusaurus/pull/6122) fix(website): fix yarn build:website:fast ([@slorber](https://github.com/slorber)) - - [#6080](https://github.com/facebook/docusaurus/pull/6080) chore: add NPM and PNPM to E2E tests ([@Josh-Cena](https://github.com/Josh-Cena)) + - [#6080](https://github.com/facebook/docusaurus/pull/6080) chore: add npm and pnpm to E2E tests ([@Josh-Cena](https://github.com/Josh-Cena)) - `create-docusaurus`, `docusaurus-cssnano-preset`, `docusaurus-mdx-loader`, `docusaurus-migrate`, `docusaurus-plugin-client-redirects`, `docusaurus-plugin-content-blog`, `docusaurus-plugin-content-docs`, `docusaurus-plugin-content-pages`, `docusaurus-plugin-debug`, `docusaurus-plugin-google-analytics`, `docusaurus-plugin-google-gtag`, `docusaurus-plugin-ideal-image`, `docusaurus-plugin-pwa`, `docusaurus-plugin-sitemap`, `docusaurus-preset-classic`, `docusaurus-remark-plugin-npm2yarn`, `docusaurus-theme-classic`, `docusaurus-theme-common`, `docusaurus-theme-live-codeblock`, `docusaurus-theme-search-algolia`, `docusaurus-theme-translations`, `docusaurus-types`, `docusaurus-utils-common`, `docusaurus-utils-validation`, `docusaurus-utils`, `docusaurus`, `lqip-loader` - [#6092](https://github.com/facebook/docusaurus/pull/6092) misc: ignore some files during npm publish ([@Josh-Cena](https://github.com/Josh-Cena)) @@ -1101,7 +1101,7 @@ Bad npm publish, use beta.13 instead - [#5903](https://github.com/facebook/docusaurus/pull/5903) docs: refer to deployed branch as deployment rather than target ([@Josh-Cena](https://github.com/Josh-Cena)) - [#5902](https://github.com/facebook/docusaurus/pull/5902) fix(website): fix i18n routes for Canny board ([@Josh-Cena](https://github.com/Josh-Cena)) - [#5900](https://github.com/facebook/docusaurus/pull/5900) docs: document global variables in MDX scope ([@Josh-Cena](https://github.com/Josh-Cena)) - - [#4409](https://github.com/facebook/docusaurus/pull/4409) docs: add example for Github Pages deployment; rewrite deployment section ([@polarathene](https://github.com/polarathene)) + - [#4409](https://github.com/facebook/docusaurus/pull/4409) docs: add example for GitHub Pages deployment; rewrite deployment section ([@polarathene](https://github.com/polarathene)) - [#5888](https://github.com/facebook/docusaurus/pull/5888) docs: update GitHub deployment instructions ([@rootwork](https://github.com/rootwork)) - [#5895](https://github.com/facebook/docusaurus/pull/5895) docs: Add juffalow.com to Docusaurus showcase ([@juffalow](https://github.com/juffalow)) - [#5881](https://github.com/facebook/docusaurus/pull/5881) docs: fix wrong code sample in docusaurus-core ([@matthijsgroen](https://github.com/matthijsgroen)) @@ -1128,7 +1128,7 @@ Bad npm publish, use beta.13 instead - [#5919](https://github.com/facebook/docusaurus/pull/5919) misc(workflow): E2E tests should not be run with website changes ([@Josh-Cena](https://github.com/Josh-Cena)) - [#5907](https://github.com/facebook/docusaurus/pull/5907) chore(workflow): merge jobs into one workflow & give each job a name ([@Josh-Cena](https://github.com/Josh-Cena)) - [#5889](https://github.com/facebook/docusaurus/pull/5889) chore(website): enable eslint in website ([@Josh-Cena](https://github.com/Josh-Cena)) - - [#5870](https://github.com/facebook/docusaurus/pull/5870) chore(README): fix broken Github Actions Workflow Status icon ([@HemantSachdeva](https://github.com/HemantSachdeva)) + - [#5870](https://github.com/facebook/docusaurus/pull/5870) chore(README): fix broken GitHub Actions Workflow Status icon ([@HemantSachdeva](https://github.com/HemantSachdeva)) - `docusaurus-module-type-aliases`, `docusaurus-types`, `docusaurus` - [#6064](https://github.com/facebook/docusaurus/pull/6064) refactor(core): fix types for client code ([@Josh-Cena](https://github.com/Josh-Cena)) - `create-docusaurus`, `docusaurus-mdx-loader`, `docusaurus-migrate`, `docusaurus-plugin-client-redirects`, `docusaurus-plugin-content-blog`, `docusaurus-plugin-content-docs`, `docusaurus-plugin-ideal-image`, `docusaurus-plugin-pwa`, `docusaurus-plugin-sitemap`, `docusaurus-theme-translations`, `docusaurus-utils`, `docusaurus` @@ -3004,7 +3004,7 @@ Starting with this release for a proper work of i18n functionality, you need to - [#3976](https://github.com/facebook/docusaurus/pull/3976) docs(v2): Add AI-Speaker site to showcase page ([@asystentka-jolka](https://github.com/asystentka-jolka)) - [#3974](https://github.com/facebook/docusaurus/pull/3974) docs(v2): doc typo on sidebar admonition ([@slorber](https://github.com/slorber)) - [#3962](https://github.com/facebook/docusaurus/pull/3962) docs(v2): Add migration info doc regarding docs folder location ([@slorber](https://github.com/slorber)) - - [#3950](https://github.com/facebook/docusaurus/pull/3950) docs(v2): update Github entreprise deployment doc ([@samhrncir](https://github.com/samhrncir)) + - [#3950](https://github.com/facebook/docusaurus/pull/3950) docs(v2): update GitHub entreprise deployment doc ([@samhrncir](https://github.com/samhrncir)) - [#3945](https://github.com/facebook/docusaurus/pull/3945) docs(v2): Added information about setting `/` in routeBasePath ([@Siemienik](https://github.com/Siemienik)) - `docusaurus-theme-classic` - [#4356](https://github.com/facebook/docusaurus/pull/4356) polish(v2): [theme-classic] add Chinese translations (zh-Hant & zh-Hans) ([@MisterFISHUP](https://github.com/MisterFISHUP)) @@ -3432,7 +3432,7 @@ Starting with this release for a proper work of i18n functionality, you need to - Other - [#3769](https://github.com/facebook/docusaurus/pull/3769) docs(v2): fix statements background, update footer background ([@Simek](https://github.com/Simek)) - - [#3744](https://github.com/facebook/docusaurus/pull/3744) chore(v2): add build size bot workflow Github CI workflow ([@jcs98](https://github.com/jcs98)) + - [#3744](https://github.com/facebook/docusaurus/pull/3744) chore(v2): add build size bot workflow GitHub CI workflow ([@jcs98](https://github.com/jcs98)) - [#3741](https://github.com/facebook/docusaurus/pull/3741) chore: update yarn lock again ([@slorber](https://github.com/slorber)) - [#3740](https://github.com/facebook/docusaurus/pull/3740) chore: update yarn lock ([@slorber](https://github.com/slorber)) - [#3738](https://github.com/facebook/docusaurus/pull/3738) chore(internal): add yarn deduplicate script, cleanup lock ([@Simek](https://github.com/Simek)) @@ -3550,7 +3550,7 @@ Failed release - Other - [#3576](https://github.com/facebook/docusaurus/pull/3576) docs(v2): removed obsolete "you" identifier ([@christian-bromann](https://github.com/christian-bromann)) - [#3589](https://github.com/facebook/docusaurus/pull/3589) docs(v2): add taro to users ([@honlyHuang](https://github.com/honlyHuang)) - - [#3565](https://github.com/facebook/docusaurus/pull/3565) docs(v2): deployment, add required Github token scope infos ([@russtaylor](https://github.com/russtaylor)) + - [#3565](https://github.com/facebook/docusaurus/pull/3565) docs(v2): deployment, add required GitHub token scope infos ([@russtaylor](https://github.com/russtaylor)) - [#3574](https://github.com/facebook/docusaurus/pull/3574) docs(v2): adding vue-nodegui to users ([@shubhamzanwar](https://github.com/shubhamzanwar)) - [#3556](https://github.com/facebook/docusaurus/pull/3556) Added Axioms to users ([@abhishektiwari](https://github.com/abhishektiwari)) - [#3558](https://github.com/facebook/docusaurus/pull/3558) docs(v2): embedding real source code in MDX as a code block ([@slorber](https://github.com/slorber)) @@ -4489,7 +4489,7 @@ Bad release, check ## 2.0.0-alpha.58 - `docusaurus-theme-search-algolia` - [#2762](https://github.com/facebook/docusaurus/pull/2762) fix(v2): avoid duplication search input in navbar ([@lex111](https://github.com/lex111)) - `lqip-loader` - - [#2693](https://github.com/facebook/docusaurus/pull/2693) fix(v2): add support esModule to lqip-loader ([@ykzts](https://github.com/ykzts)) + - [#2693](https://github.com/facebook/docusaurus/pull/2693) fix(v2): add support ES Module to lqip-loader ([@ykzts](https://github.com/ykzts)) - `docusaurus-init` - [#2751](https://github.com/facebook/docusaurus/pull/2751) fix(v2): fix index page features.length when 0 ([@jdeniau](https://github.com/jdeniau)) @@ -4998,7 +4998,7 @@ Bad release, check ## 2.0.0-alpha.58 - [#2253](https://github.com/facebook/docusaurus/pull/2253) feat(v2): allow specify custom link for logo ([@lex111](https://github.com/lex111)) - [#2255](https://github.com/facebook/docusaurus/pull/2255) feat(v2): add site title to meta title ([@lex111](https://github.com/lex111)) - `docusaurus-plugin-content-pages`, `docusaurus-utils`, `docusaurus` - - [#2221](https://github.com/facebook/docusaurus/pull/2221) feat(v2): allow for Typescript pages and components ([@jonathanrdelgado](https://github.com/jonathanrdelgado)) + - [#2221](https://github.com/facebook/docusaurus/pull/2221) feat(v2): allow for TypeScript pages and components ([@jonathanrdelgado](https://github.com/jonathanrdelgado)) #### :boom: Breaking Change @@ -5623,7 +5623,7 @@ If you are still encountering the error. Please check whether you use `module.ex ## 2.0.0-alpha.24 (2019-07-24) - Remove unused metadata for pages. This minimize number of http request & smaller bundle size. -- Upgrade dependencies of css-loader from 2.x to 3.x. Css modules localIdentName hash now only use the last 4 characters instead of 8. +- Upgrade dependencies of css-loader from 2.x to 3.x. CSS modules localIdentName hash now only use the last 4 characters instead of 8. - Fix broken markdown linking replacement for mdx files - Fix potential security vulnerability because we're exposing the directory structure of the host machine. Instead of absolute path, we use relative path from site directory. Resulting in shorter webpack chunk naming and smaller bundle size. - Use contenthash instead of chunkhash for better long term caching diff --git a/README.md b/README.md index c2fe1a76ae..310374e762 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ npm version - Github Actions status + GitHub Actions status PRs Welcome Discord Chat code style: prettier diff --git a/admin/publish.md b/admin/publish.md index fef93b5879..a46ed99e6f 100644 --- a/admin/publish.md +++ b/admin/publish.md @@ -10,7 +10,7 @@ Get access from the Docusaurus npm admins (@yangshun/@JoelMarcey). You need publish access to **the main Docusaurus repository** (not a fork). -## NPM +## npm Publishing will only work if you are logged into npm with an account with publishing rights to the package. @@ -78,7 +78,7 @@ The `tag:` label prefix is for PRs only. Other labels are not used by the change Generate a GitHub auth token by going to https://github.com/settings/tokens (the only permission needed is `public_repo`). Save the token somewhere for future reference. -Fetch the tags from Github (lerna-changelog looks for commits since last tag by default): +Fetch the tags from GitHub (lerna-changelog looks for commits since last tag by default): ```sh git fetch --tags @@ -163,7 +163,7 @@ npm access ls-packages -It can happen that some accesses are not granted, as an admin might add you to the @docusaurus NPM organization, but you don't have access to the packages that are not in that organization. +It can happen that some accesses are not granted, as an admin might add you to the @docusaurus npm organization, but you don't have access to the packages that are not in that organization. Please **double-check your permissions on these packages**, otherwise you'll publish a half-release and will have to release a new version. diff --git a/admin/testing-changes-on-Docusaurus-itself.md b/admin/testing-changes-on-Docusaurus-itself.md index 36db02d9a7..fe9da4c63a 100644 --- a/admin/testing-changes-on-Docusaurus-itself.md +++ b/admin/testing-changes-on-Docusaurus-itself.md @@ -17,7 +17,7 @@ yarn start ### VS Code -Use the following code in VSCode to enable breakpoints. Please ensure you have a later version of node for non-legacy debugging. +Use the following code in VS Code to enable breakpoints. Please ensure you have a later version of node for non-legacy debugging. ```json { diff --git a/packages/create-docusaurus/src/index.ts b/packages/create-docusaurus/src/index.ts index 1ca4627e70..4358ee0203 100755 --- a/packages/create-docusaurus/src/index.ts +++ b/packages/create-docusaurus/src/index.ts @@ -55,12 +55,12 @@ function findPackageManagerFromUserAgent(): async function askForPackageManagerChoice(): Promise { const hasYarn = shell.exec('yarn --version', {silent: true}).code === 0; - const hasPNPM = shell.exec('pnpm --version', {silent: true}).code === 0; + const hasPnpm = shell.exec('pnpm --version', {silent: true}).code === 0; - if (!hasYarn && !hasPNPM) { + if (!hasYarn && !hasPnpm) { return 'npm'; } - const choices = ['npm', hasYarn && 'yarn', hasPNPM && 'pnpm'] + const choices = ['npm', hasYarn && 'yarn', hasPnpm && 'pnpm'] .filter((p): p is string => Boolean(p)) .map((p) => ({title: p, value: p})); @@ -165,7 +165,7 @@ async function copyTemplate( } await fs.copy(path.resolve(templatesDir, template), dest, { - // Symlinks don't exist in published NPM packages anymore, so this is only + // Symlinks don't exist in published npm packages anymore, so this is only // to prevent errors during local testing filter: async (filePath) => !(await fs.lstat(filePath)).isSymbolicLink(), }); @@ -337,7 +337,7 @@ export default async function init( // Docusaurus templates. if (useTS) { if (!(await hasTS(template))) { - logger.error`Template name=${template} doesn't provide the Typescript variant.`; + logger.error`Template name=${template} doesn't provide the TypeScript variant.`; process.exit(1); } template = `${template}${TypeScriptTemplateSuffix}`; diff --git a/packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/simple-site/sidebars.json b/packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/simple-site/sidebars.json index d1e019d2e4..7f74d2280b 100644 --- a/packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/simple-site/sidebars.json +++ b/packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/simple-site/sidebars.json @@ -25,7 +25,7 @@ }, { "type": "link", - "label": "Github", + "label": "GitHub", "href": "https://github.com" }, { diff --git a/packages/docusaurus-plugin-content-docs/src/__tests__/__snapshots__/cli.test.ts.snap b/packages/docusaurus-plugin-content-docs/src/__tests__/__snapshots__/cli.test.ts.snap index 2f4d4e94fa..668d5277e9 100644 --- a/packages/docusaurus-plugin-content-docs/src/__tests__/__snapshots__/cli.test.ts.snap +++ b/packages/docusaurus-plugin-content-docs/src/__tests__/__snapshots__/cli.test.ts.snap @@ -34,7 +34,7 @@ exports[`docsVersion first time versioning 1`] = ` }, { "href": "https://github.com", - "label": "Github", + "label": "GitHub", "type": "link", }, { diff --git a/packages/docusaurus-plugin-content-docs/src/__tests__/__snapshots__/index.test.ts.snap b/packages/docusaurus-plugin-content-docs/src/__tests__/__snapshots__/index.test.ts.snap index 44346d589b..55f087ee4e 100644 --- a/packages/docusaurus-plugin-content-docs/src/__tests__/__snapshots__/index.test.ts.snap +++ b/packages/docusaurus-plugin-content-docs/src/__tests__/__snapshots__/index.test.ts.snap @@ -225,7 +225,7 @@ exports[`simple website content 4`] = ` }, { "href": "https://github.com", - "label": "Github", + "label": "GitHub", "type": "link", }, { @@ -850,7 +850,7 @@ exports[`simple website content: data 1`] = ` }, { \\"type\\": \\"link\\", - \\"label\\": \\"Github\\", + \\"label\\": \\"GitHub\\", \\"href\\": \\"https://github.com\\" }, { diff --git a/packages/docusaurus-plugin-content-docs/src/sidebars/__tests__/__fixtures__/sidebars/sidebars.json b/packages/docusaurus-plugin-content-docs/src/sidebars/__tests__/__fixtures__/sidebars/sidebars.json index e355c9b3f0..b9422da7b7 100644 --- a/packages/docusaurus-plugin-content-docs/src/sidebars/__tests__/__fixtures__/sidebars/sidebars.json +++ b/packages/docusaurus-plugin-content-docs/src/sidebars/__tests__/__fixtures__/sidebars/sidebars.json @@ -5,7 +5,7 @@ "foo/baz", { "type": "link", - "label": "Github", + "label": "GitHub", "href": "https://github.com" }, { diff --git a/packages/docusaurus-plugin-content-docs/src/sidebars/__tests__/__snapshots__/index.test.ts.snap b/packages/docusaurus-plugin-content-docs/src/sidebars/__tests__/__snapshots__/index.test.ts.snap index 42b1cd180d..8657b009a8 100644 --- a/packages/docusaurus-plugin-content-docs/src/sidebars/__tests__/__snapshots__/index.test.ts.snap +++ b/packages/docusaurus-plugin-content-docs/src/sidebars/__tests__/__snapshots__/index.test.ts.snap @@ -218,7 +218,7 @@ exports[`loadSidebars sidebars with known sidebar item type 1`] = ` }, { "href": "https://github.com", - "label": "Github", + "label": "GitHub", "type": "link", }, { diff --git a/packages/docusaurus-plugin-content-docs/src/sidebars/__tests__/validation.test.ts b/packages/docusaurus-plugin-content-docs/src/sidebars/__tests__/validation.test.ts index 96887b889c..c5a09a6be6 100644 --- a/packages/docusaurus-plugin-content-docs/src/sidebars/__tests__/validation.test.ts +++ b/packages/docusaurus-plugin-content-docs/src/sidebars/__tests__/validation.test.ts @@ -228,7 +228,7 @@ describe('validateSidebars', () => { `); }); - it('hTML type requires a value', () => { + it('html type requires a value', () => { const sidebars: SidebarsConfig = { sidebar1: [ { @@ -248,7 +248,7 @@ describe('validateSidebars', () => { `); }); - it('hTML type accepts valid values', () => { + it('html type accepts valid values', () => { const sidebars: SidebarsConfig = { sidebar1: [ { diff --git a/packages/docusaurus-theme-classic/src/__tests__/validateThemeConfig.test.ts b/packages/docusaurus-theme-classic/src/__tests__/validateThemeConfig.test.ts index d2cb4d7184..a333f882b5 100644 --- a/packages/docusaurus-theme-classic/src/__tests__/validateThemeConfig.test.ts +++ b/packages/docusaurus-theme-classic/src/__tests__/validateThemeConfig.test.ts @@ -145,7 +145,7 @@ describe('themeConfig', () => { { type: 'doc', docId: 'npm', - label: 'NPM', + label: 'npm', }, { to: '/yarn', diff --git a/packages/docusaurus-utils/src/pathUtils.ts b/packages/docusaurus-utils/src/pathUtils.ts index f8380ec87d..30db78bd7b 100644 --- a/packages/docusaurus-utils/src/pathUtils.ts +++ b/packages/docusaurus-utils/src/pathUtils.ts @@ -8,7 +8,7 @@ import path from 'path'; // Based on https://github.com/gatsbyjs/gatsby/pull/21518/files -// MacOS (APFS) and Windows (NTFS) filename length limit = 255 chars, +// macOS (APFS) and Windows (NTFS) filename length limit = 255 chars, // Others = 255 bytes const MAX_PATH_SEGMENT_CHARS = 255; const MAX_PATH_SEGMENT_BYTES = 255; @@ -21,7 +21,7 @@ const isWindows = () => process.platform === 'win32'; export const isNameTooLong = (str: string): boolean => // Not entirely correct: we can't assume FS from OS. But good enough? isMacOs() || isWindows() - ? str.length + SPACE_FOR_APPENDING > MAX_PATH_SEGMENT_CHARS // MacOS (APFS) and Windows (NTFS) filename length limit (255 chars) + ? str.length + SPACE_FOR_APPENDING > MAX_PATH_SEGMENT_CHARS // macOS (APFS) and Windows (NTFS) filename length limit (255 chars) : Buffer.from(str).length + SPACE_FOR_APPENDING > MAX_PATH_SEGMENT_BYTES; // Other (255 bytes) export function shortName(str: string): string { diff --git a/website/blog/2021-03-09-releasing-docusaurus-i18n.md b/website/blog/2021-03-09-releasing-docusaurus-i18n.md index 8cb0b14116..a7efa79d12 100644 --- a/website/blog/2021-03-09-releasing-docusaurus-i18n.md +++ b/website/blog/2021-03-09-releasing-docusaurus-i18n.md @@ -87,7 +87,7 @@ This feature has not been an easy one, and we would like to thank everyone that - [Claire](https://github.com/clairefro) for adopting Docusaurus 2 on the new Redwood platform and providing many feedbacks - [Massoud](https://github.com/massoudmaboudi) for reviewing my work on LTR and adopting it on Datagit - [Crowdin](https://crowdin.com/) for their support and willingness to improve their translation SaaS -- The Docusaurus community for their patience, and providing many useful feedbacks on Github +- The Docusaurus community for their patience, and providing many useful feedbacks on GitHub Thanks for reading. diff --git a/website/blog/2022-01-24-docusaurus-2021-recap/index.md b/website/blog/2022-01-24-docusaurus-2021-recap/index.md index 7059860326..6c4c29800a 100644 --- a/website/blog/2022-01-24-docusaurus-2021-recap/index.md +++ b/website/blog/2022-01-24-docusaurus-2021-recap/index.md @@ -34,11 +34,11 @@ Our codebase has been polished over time as well. We have improved test coverage ## Trends -### NPM +### npm Docusaurus v2 continues to grow steadily. V2 installation is now 8 times more than v1. In terms of weekly downloads, we have witnessed another three-fold increase (+209.4%), growing from 28,066 in early January to a peak of 86,846 in mid-December. -[![NPM download trend](./img/npm-trend.png)](https://www.npmtrends.com/docusaurus-vs-@docusaurus/core) +[![npm download trend](./img/npm-trend.png)](https://www.npmtrends.com/docusaurus-vs-@docusaurus/core) (Ah, the classic Christmas dip...) diff --git a/website/docs/advanced/plugins.md b/website/docs/advanced/plugins.md index 3e6e9f969f..2960263eca 100644 --- a/website/docs/advanced/plugins.md +++ b/website/docs/advanced/plugins.md @@ -35,7 +35,7 @@ module.exports = { ### Module definition {#module-definition} -You can use a plugin as a module path referencing a separate file or NPM package: +You can use a plugin as a module path referencing a separate file or npm package: ```js title="docusaurus.config.js" module.exports = { diff --git a/website/docs/deployment.mdx b/website/docs/deployment.mdx index d2016ed0d5..4c31590261 100644 --- a/website/docs/deployment.mdx +++ b/website/docs/deployment.mdx @@ -522,7 +522,7 @@ jobs: ### Triggering deployment with Travis CI {#triggering-deployment-with-travis-ci} -Continuous integration (CI) services are typically used to perform routine tasks whenever new commits are checked in to source control. These tasks can be any combination of running unit tests and integration tests, automating builds, publishing packages to NPM, and deploying changes to your website. All you need to do to automate the deployment of your website is to invoke the `yarn deploy` script whenever your website is updated. The following section covers how to do just that using [Travis CI](https://travis-ci.com/), a popular continuous integration service provider. +Continuous integration (CI) services are typically used to perform routine tasks whenever new commits are checked in to source control. These tasks can be any combination of running unit tests and integration tests, automating builds, publishing packages to npm, and deploying changes to your website. All you need to do to automate the deployment of your website is to invoke the `yarn deploy` script whenever your website is updated. The following section covers how to do just that using [Travis CI](https://travis-ci.com/), a popular continuous integration service provider. 1. Go to https://github.com/settings/tokens and generate a new [personal access token](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/). When creating the token, grant it the `repo` scope so that it has the permissions it needs. 2. Using your GitHub account, [add the Travis CI app](https://github.com/marketplace/travis-ci) to the repository you want to activate. diff --git a/website/docs/guides/creating-pages.md b/website/docs/guides/creating-pages.md index 160b4dbf1d..f8745e6cbf 100644 --- a/website/docs/guides/creating-pages.md +++ b/website/docs/guides/creating-pages.md @@ -115,7 +115,7 @@ This is merely a recommended directory structure, and you will still need to man ::: -By default, any Markdown or Javascript file starting with `_` will be ignored and no routes will be created for that file (see the `exclude` option). +By default, any Markdown or JavaScript file starting with `_` will be ignored and no routes will be created for that file (see the `exclude` option). ```bash my-website diff --git a/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx b/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx index 085d944ca4..1cdc53d72e 100644 --- a/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx +++ b/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx @@ -534,7 +534,7 @@ If you have multiple of these multi-language code tabs, and you want to sync the ### Docusaurus npm2yarn remark plugin {#npm2yarn-remark-plugin} -Displaying CLI commands in both NPM and Yarn is a very common need, for example: +Displaying CLI commands in both npm and Yarn is a very common need, for example: ```bash npm2yarn npm install @docusaurus/remark-plugin-npm2yarn diff --git a/website/docs/guides/markdown-features/markdown-features-plugins.mdx b/website/docs/guides/markdown-features/markdown-features-plugins.mdx index 8033833585..7c78af39d8 100644 --- a/website/docs/guides/markdown-features/markdown-features-plugins.mdx +++ b/website/docs/guides/markdown-features/markdown-features-plugins.mdx @@ -124,7 +124,7 @@ The writeup below is **not** meant to be a comprehensive guide to creating a plu ::: -For example, let's make a plugin that visits every `h2` heading and adds a `Section X. ` prefix. First, create your plugin source file anywhere—you can even publish it as a separate NPM package and install it like explained above. We would put ours at `src/remark/section-prefix.js`. A remark/rehype plugin is just a function that receives the `options` and returns a `transformer` that operates on the AST. +For example, let's make a plugin that visits every `h2` heading and adds a `Section X. ` prefix. First, create your plugin source file anywhere—you can even publish it as a separate npm package and install it like explained above. We would put ours at `src/remark/section-prefix.js`. A remark/rehype plugin is just a function that receives the `options` and returns a `transformer` that operates on the AST. ```js "src/remark/section-prefix.js" const visit = require('unist-util-visit'); diff --git a/website/docs/guides/markdown-features/markdown-features-tabs.mdx b/website/docs/guides/markdown-features/markdown-features-tabs.mdx index 062a9abe54..e5364735ff 100644 --- a/website/docs/guides/markdown-features/markdown-features-tabs.mdx +++ b/website/docs/guides/markdown-features/markdown-features-tabs.mdx @@ -142,13 +142,13 @@ You may want choices of the same kind of tabs to sync with each other. For examp // highlight-next-line Use Ctrl + C to copy. - Use Command + C to copy. + Use Command + C to copy. // highlight-next-line Use Ctrl + V to paste. - Use Command + V to paste. + Use Command + V to paste. ``` @@ -156,12 +156,12 @@ You may want choices of the same kind of tabs to sync with each other. For examp Use Ctrl + C to copy. - Use Command + C to copy. + Use Command + C to copy. Use Ctrl + V to paste. - Use Command + V to paste. + Use Command + V to paste.
@@ -174,7 +174,7 @@ For all tab groups that have the same `groupId`, the possible values do not need I am Windows. - + I am macOS. @@ -187,7 +187,7 @@ For all tab groups that have the same `groupId`, the possible values do not need I am Windows. - I am macOS. + I am macOS. I am Linux. @@ -201,7 +201,7 @@ Tab choices with different group IDs will not interfere with each other: // highlight-next-line Windows in windows. - macOS is macOS. + macOS is macOS. // highlight-next-line @@ -215,7 +215,7 @@ Tab choices with different group IDs will not interfere with each other: Windows in windows. - macOS is macOS. + macOS is macOS. diff --git a/website/docs/i18n/i18n-crowdin.mdx b/website/docs/i18n/i18n-crowdin.mdx index bed65e157e..60afe1f10b 100644 --- a/website/docs/i18n/i18n-crowdin.mdx +++ b/website/docs/i18n/i18n-crowdin.mdx @@ -182,7 +182,7 @@ You should **not commit** it, and it may be a good idea to create a dedicated ** This tutorial uses the CLI version `3.5.2`, but we expect `3.x` releases to keep working. -Install the Crowdin CLI as an NPM package to your Docusaurus site: +Install the Crowdin CLI as an npm package to your Docusaurus site: ```bash npm2yarn npm install @crowdin/cli@3 @@ -468,7 +468,7 @@ module.exports = { if (locale !== DefaultLocale) { return `https://crowdin.com/project/docusaurus-v2/${locale}`; } - // Link to Github for English docs + // Link to GitHub for English docs return `https://github.com/facebook/docusaurus/edit/main/website/${versionDocsDirPath}/${docPath}`; }, // highlight-end diff --git a/website/docs/i18n/i18n-tutorial.md b/website/docs/i18n/i18n-tutorial.md index 477b89d5af..3d20fa3d86 100644 --- a/website/docs/i18n/i18n-tutorial.md +++ b/website/docs/i18n/i18n-tutorial.md @@ -437,7 +437,7 @@ On your [static hosting provider](../deployment.mdx): :::caution -This strategy is **not possible** with Github Pages, as it is only possible to **have a single deployment**. +This strategy is **not possible** with GitHub Pages, as it is only possible to **have a single deployment**. ::: diff --git a/website/docs/typescript-support.md b/website/docs/typescript-support.md index 13f6ad5715..25c36c2c59 100644 --- a/website/docs/typescript-support.md +++ b/website/docs/typescript-support.md @@ -7,7 +7,7 @@ Docusaurus is written in TypeScript and provides first-class TypeScript support. ## Initialization {#initialization} -Docusaurus supports writing and using TypeScript theme components. If the init template provides a Typescript variant, you can directly initialize a site with full TypeScript support by using the `--typescript` flag. +Docusaurus supports writing and using TypeScript theme components. If the init template provides a TypeScript variant, you can directly initialize a site with full TypeScript support by using the `--typescript` flag. ```bash npx create-docusaurus@latest my-website classic --typescript @@ -104,7 +104,7 @@ module.exports = config; Type annotations are very useful and help your IDE understand the type of config objects! -The best IDEs (VSCode, WebStorm, IntelliJ...) will provide a nice auto-completion experience. +The best IDEs (VS Code, WebStorm, IntelliJ...) will provide a nice auto-completion experience. ::: diff --git a/website/src/data/users.tsx b/website/src/data/users.tsx index 13343e4c0e..56da2130b3 100644 --- a/website/src/data/users.tsx +++ b/website/src/data/users.tsx @@ -30,7 +30,7 @@ import {sortBy} from '@site/src/utils/jsUtils'; * * Example PR: https://github.com/facebook/docusaurus/pull/3976 * - * If you edit this file through the Github interface, you can: + * If you edit this file through the GitHub interface, you can: * - Submit first your users.tsx edit PR * - This will create a branch on your Docusaurus fork (usually "patch-1") * - Go to https://github.com//docusaurus/tree//website/src/data/showcase @@ -281,7 +281,7 @@ const Users: User[] = [ { title: 'Blog Matheus Brunelli', description: - 'Desenvolvimento de software, carreira, dicas de livros e muito Javascript!', + 'Desenvolvimento de software, carreira, dicas de livros e muito JavaScript!', preview: require('./showcase/blogmatheusbrunelli.png'), website: 'https://mrbrunelli.github.io/blog/', source: 'https://github.com/mrbrunelli/blog', @@ -624,7 +624,7 @@ const Users: User[] = [ }, { title: 'FirelordJS', - description: 'Typescript Wrapper for Firestore', + description: 'TypeScript Wrapper for Firestore', preview: require('./showcase/firelordjs.png'), website: 'https://firelordjs.com', source: 'https://github.com/tylim88/FirelordJSDoc', @@ -1008,7 +1008,7 @@ const Users: User[] = [ { title: 'Molecule', description: - 'Molecule is a lightweight Web IDE UI framework built with React.js and inspired by VSCode.', + 'Molecule is a lightweight Web IDE UI framework built with React.js and inspired by VS Code.', preview: require('./showcase/molecule-home.png'), website: 'https://dtstack.github.io/molecule/', source: 'https://github.com/DTStack/molecule/tree/main/website', diff --git a/website/versioned_docs/version-2.0.0-beta.17/advanced/plugins.md b/website/versioned_docs/version-2.0.0-beta.17/advanced/plugins.md index 3e6e9f969f..2960263eca 100644 --- a/website/versioned_docs/version-2.0.0-beta.17/advanced/plugins.md +++ b/website/versioned_docs/version-2.0.0-beta.17/advanced/plugins.md @@ -35,7 +35,7 @@ module.exports = { ### Module definition {#module-definition} -You can use a plugin as a module path referencing a separate file or NPM package: +You can use a plugin as a module path referencing a separate file or npm package: ```js title="docusaurus.config.js" module.exports = { diff --git a/website/versioned_docs/version-2.0.0-beta.17/deployment.mdx b/website/versioned_docs/version-2.0.0-beta.17/deployment.mdx index d2016ed0d5..4c31590261 100644 --- a/website/versioned_docs/version-2.0.0-beta.17/deployment.mdx +++ b/website/versioned_docs/version-2.0.0-beta.17/deployment.mdx @@ -522,7 +522,7 @@ jobs: ### Triggering deployment with Travis CI {#triggering-deployment-with-travis-ci} -Continuous integration (CI) services are typically used to perform routine tasks whenever new commits are checked in to source control. These tasks can be any combination of running unit tests and integration tests, automating builds, publishing packages to NPM, and deploying changes to your website. All you need to do to automate the deployment of your website is to invoke the `yarn deploy` script whenever your website is updated. The following section covers how to do just that using [Travis CI](https://travis-ci.com/), a popular continuous integration service provider. +Continuous integration (CI) services are typically used to perform routine tasks whenever new commits are checked in to source control. These tasks can be any combination of running unit tests and integration tests, automating builds, publishing packages to npm, and deploying changes to your website. All you need to do to automate the deployment of your website is to invoke the `yarn deploy` script whenever your website is updated. The following section covers how to do just that using [Travis CI](https://travis-ci.com/), a popular continuous integration service provider. 1. Go to https://github.com/settings/tokens and generate a new [personal access token](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/). When creating the token, grant it the `repo` scope so that it has the permissions it needs. 2. Using your GitHub account, [add the Travis CI app](https://github.com/marketplace/travis-ci) to the repository you want to activate. diff --git a/website/versioned_docs/version-2.0.0-beta.17/guides/creating-pages.md b/website/versioned_docs/version-2.0.0-beta.17/guides/creating-pages.md index bf4c277d4a..b7a5495893 100644 --- a/website/versioned_docs/version-2.0.0-beta.17/guides/creating-pages.md +++ b/website/versioned_docs/version-2.0.0-beta.17/guides/creating-pages.md @@ -117,7 +117,7 @@ This is merely a recommended directory structure, and you will still need to man ::: -By default, any Markdown or Javascript file starting with `_` will be ignored and no routes will be created for that file (see the `exclude` option). +By default, any Markdown or JavaScript file starting with `_` will be ignored and no routes will be created for that file (see the `exclude` option). ```bash my-website diff --git a/website/versioned_docs/version-2.0.0-beta.17/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-2.0.0-beta.17/guides/markdown-features/markdown-features-code-blocks.mdx index 7934b6ebaa..8862a7fd50 100644 --- a/website/versioned_docs/version-2.0.0-beta.17/guides/markdown-features/markdown-features-code-blocks.mdx +++ b/website/versioned_docs/version-2.0.0-beta.17/guides/markdown-features/markdown-features-code-blocks.mdx @@ -526,7 +526,7 @@ If you have multiple of these multi-language code tabs, and you want to sync the ### Docusaurus npm2yarn remark plugin {#npm2yarn-remark-plugin} -Displaying CLI commands in both NPM and Yarn is a very common need, for example: +Displaying CLI commands in both npm and Yarn is a very common need, for example: ```bash npm2yarn npm install @docusaurus/remark-plugin-npm2yarn diff --git a/website/versioned_docs/version-2.0.0-beta.17/guides/markdown-features/markdown-features-plugins.mdx b/website/versioned_docs/version-2.0.0-beta.17/guides/markdown-features/markdown-features-plugins.mdx index 8033833585..7c78af39d8 100644 --- a/website/versioned_docs/version-2.0.0-beta.17/guides/markdown-features/markdown-features-plugins.mdx +++ b/website/versioned_docs/version-2.0.0-beta.17/guides/markdown-features/markdown-features-plugins.mdx @@ -124,7 +124,7 @@ The writeup below is **not** meant to be a comprehensive guide to creating a plu ::: -For example, let's make a plugin that visits every `h2` heading and adds a `Section X. ` prefix. First, create your plugin source file anywhere—you can even publish it as a separate NPM package and install it like explained above. We would put ours at `src/remark/section-prefix.js`. A remark/rehype plugin is just a function that receives the `options` and returns a `transformer` that operates on the AST. +For example, let's make a plugin that visits every `h2` heading and adds a `Section X. ` prefix. First, create your plugin source file anywhere—you can even publish it as a separate npm package and install it like explained above. We would put ours at `src/remark/section-prefix.js`. A remark/rehype plugin is just a function that receives the `options` and returns a `transformer` that operates on the AST. ```js "src/remark/section-prefix.js" const visit = require('unist-util-visit'); diff --git a/website/versioned_docs/version-2.0.0-beta.17/guides/markdown-features/markdown-features-tabs.mdx b/website/versioned_docs/version-2.0.0-beta.17/guides/markdown-features/markdown-features-tabs.mdx index 55ce040ead..e338dcc5e7 100644 --- a/website/versioned_docs/version-2.0.0-beta.17/guides/markdown-features/markdown-features-tabs.mdx +++ b/website/versioned_docs/version-2.0.0-beta.17/guides/markdown-features/markdown-features-tabs.mdx @@ -142,13 +142,13 @@ You may want choices of the same kind of tabs to sync with each other. For examp // highlight-next-line Use Ctrl + C to copy. - Use Command + C to copy. + Use Command + C to copy. // highlight-next-line Use Ctrl + V to paste. - Use Command + V to paste. + Use Command + V to paste. ``` @@ -156,12 +156,12 @@ You may want choices of the same kind of tabs to sync with each other. For examp Use Ctrl + C to copy. - Use Command + C to copy. + Use Command + C to copy. Use Ctrl + V to paste. - Use Command + V to paste. + Use Command + V to paste.
@@ -174,7 +174,7 @@ For all tab groups that have the same `groupId`, the possible values do not need I am Windows. - + I am macOS. @@ -187,7 +187,7 @@ For all tab groups that have the same `groupId`, the possible values do not need I am Windows. - I am macOS. + I am macOS. I am Linux. @@ -201,7 +201,7 @@ Tab choices with different group IDs will not interfere with each other: // highlight-next-line Windows in windows. - macOS is macOS. + macOS is macOS. // highlight-next-line @@ -215,7 +215,7 @@ Tab choices with different group IDs will not interfere with each other: Windows in windows. - macOS is macOS. + macOS is macOS. diff --git a/website/versioned_docs/version-2.0.0-beta.17/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-2.0.0-beta.17/i18n/i18n-crowdin.mdx index bed65e157e..60afe1f10b 100644 --- a/website/versioned_docs/version-2.0.0-beta.17/i18n/i18n-crowdin.mdx +++ b/website/versioned_docs/version-2.0.0-beta.17/i18n/i18n-crowdin.mdx @@ -182,7 +182,7 @@ You should **not commit** it, and it may be a good idea to create a dedicated ** This tutorial uses the CLI version `3.5.2`, but we expect `3.x` releases to keep working. -Install the Crowdin CLI as an NPM package to your Docusaurus site: +Install the Crowdin CLI as an npm package to your Docusaurus site: ```bash npm2yarn npm install @crowdin/cli@3 @@ -468,7 +468,7 @@ module.exports = { if (locale !== DefaultLocale) { return `https://crowdin.com/project/docusaurus-v2/${locale}`; } - // Link to Github for English docs + // Link to GitHub for English docs return `https://github.com/facebook/docusaurus/edit/main/website/${versionDocsDirPath}/${docPath}`; }, // highlight-end diff --git a/website/versioned_docs/version-2.0.0-beta.17/i18n/i18n-tutorial.md b/website/versioned_docs/version-2.0.0-beta.17/i18n/i18n-tutorial.md index 477b89d5af..3d20fa3d86 100644 --- a/website/versioned_docs/version-2.0.0-beta.17/i18n/i18n-tutorial.md +++ b/website/versioned_docs/version-2.0.0-beta.17/i18n/i18n-tutorial.md @@ -437,7 +437,7 @@ On your [static hosting provider](../deployment.mdx): :::caution -This strategy is **not possible** with Github Pages, as it is only possible to **have a single deployment**. +This strategy is **not possible** with GitHub Pages, as it is only possible to **have a single deployment**. ::: diff --git a/website/versioned_docs/version-2.0.0-beta.17/typescript-support.md b/website/versioned_docs/version-2.0.0-beta.17/typescript-support.md index 3f9e097168..abfa0ec426 100644 --- a/website/versioned_docs/version-2.0.0-beta.17/typescript-support.md +++ b/website/versioned_docs/version-2.0.0-beta.17/typescript-support.md @@ -7,7 +7,7 @@ Docusaurus is written in TypeScript and provides first-class TypeScript support. ## Initialization {#initialization} -Docusaurus supports writing and using TypeScript theme components. If the init template provides a Typescript variant, you can directly initialize a site with full TypeScript support by using the `--typescript` flag. +Docusaurus supports writing and using TypeScript theme components. If the init template provides a TypeScript variant, you can directly initialize a site with full TypeScript support by using the `--typescript` flag. ```bash npx create-docusaurus@latest my-website classic --typescript @@ -104,7 +104,7 @@ module.exports = config; Type annotations are very useful and help your IDE understand the type of config objects! -The best IDEs (VSCode, WebStorm, IntelliJ...) will provide a nice auto-completion experience. +The best IDEs (VS Code, WebStorm, IntelliJ...) will provide a nice auto-completion experience. ::: diff --git a/website/versioned_docs/version-2.0.0-beta.18/advanced/plugins.md b/website/versioned_docs/version-2.0.0-beta.18/advanced/plugins.md index 3e6e9f969f..2960263eca 100644 --- a/website/versioned_docs/version-2.0.0-beta.18/advanced/plugins.md +++ b/website/versioned_docs/version-2.0.0-beta.18/advanced/plugins.md @@ -35,7 +35,7 @@ module.exports = { ### Module definition {#module-definition} -You can use a plugin as a module path referencing a separate file or NPM package: +You can use a plugin as a module path referencing a separate file or npm package: ```js title="docusaurus.config.js" module.exports = { diff --git a/website/versioned_docs/version-2.0.0-beta.18/deployment.mdx b/website/versioned_docs/version-2.0.0-beta.18/deployment.mdx index d2016ed0d5..4c31590261 100644 --- a/website/versioned_docs/version-2.0.0-beta.18/deployment.mdx +++ b/website/versioned_docs/version-2.0.0-beta.18/deployment.mdx @@ -522,7 +522,7 @@ jobs: ### Triggering deployment with Travis CI {#triggering-deployment-with-travis-ci} -Continuous integration (CI) services are typically used to perform routine tasks whenever new commits are checked in to source control. These tasks can be any combination of running unit tests and integration tests, automating builds, publishing packages to NPM, and deploying changes to your website. All you need to do to automate the deployment of your website is to invoke the `yarn deploy` script whenever your website is updated. The following section covers how to do just that using [Travis CI](https://travis-ci.com/), a popular continuous integration service provider. +Continuous integration (CI) services are typically used to perform routine tasks whenever new commits are checked in to source control. These tasks can be any combination of running unit tests and integration tests, automating builds, publishing packages to npm, and deploying changes to your website. All you need to do to automate the deployment of your website is to invoke the `yarn deploy` script whenever your website is updated. The following section covers how to do just that using [Travis CI](https://travis-ci.com/), a popular continuous integration service provider. 1. Go to https://github.com/settings/tokens and generate a new [personal access token](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/). When creating the token, grant it the `repo` scope so that it has the permissions it needs. 2. Using your GitHub account, [add the Travis CI app](https://github.com/marketplace/travis-ci) to the repository you want to activate. diff --git a/website/versioned_docs/version-2.0.0-beta.18/guides/creating-pages.md b/website/versioned_docs/version-2.0.0-beta.18/guides/creating-pages.md index 160b4dbf1d..f8745e6cbf 100644 --- a/website/versioned_docs/version-2.0.0-beta.18/guides/creating-pages.md +++ b/website/versioned_docs/version-2.0.0-beta.18/guides/creating-pages.md @@ -115,7 +115,7 @@ This is merely a recommended directory structure, and you will still need to man ::: -By default, any Markdown or Javascript file starting with `_` will be ignored and no routes will be created for that file (see the `exclude` option). +By default, any Markdown or JavaScript file starting with `_` will be ignored and no routes will be created for that file (see the `exclude` option). ```bash my-website diff --git a/website/versioned_docs/version-2.0.0-beta.18/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-2.0.0-beta.18/guides/markdown-features/markdown-features-code-blocks.mdx index 085d944ca4..1cdc53d72e 100644 --- a/website/versioned_docs/version-2.0.0-beta.18/guides/markdown-features/markdown-features-code-blocks.mdx +++ b/website/versioned_docs/version-2.0.0-beta.18/guides/markdown-features/markdown-features-code-blocks.mdx @@ -534,7 +534,7 @@ If you have multiple of these multi-language code tabs, and you want to sync the ### Docusaurus npm2yarn remark plugin {#npm2yarn-remark-plugin} -Displaying CLI commands in both NPM and Yarn is a very common need, for example: +Displaying CLI commands in both npm and Yarn is a very common need, for example: ```bash npm2yarn npm install @docusaurus/remark-plugin-npm2yarn diff --git a/website/versioned_docs/version-2.0.0-beta.18/guides/markdown-features/markdown-features-plugins.mdx b/website/versioned_docs/version-2.0.0-beta.18/guides/markdown-features/markdown-features-plugins.mdx index 8033833585..7c78af39d8 100644 --- a/website/versioned_docs/version-2.0.0-beta.18/guides/markdown-features/markdown-features-plugins.mdx +++ b/website/versioned_docs/version-2.0.0-beta.18/guides/markdown-features/markdown-features-plugins.mdx @@ -124,7 +124,7 @@ The writeup below is **not** meant to be a comprehensive guide to creating a plu ::: -For example, let's make a plugin that visits every `h2` heading and adds a `Section X. ` prefix. First, create your plugin source file anywhere—you can even publish it as a separate NPM package and install it like explained above. We would put ours at `src/remark/section-prefix.js`. A remark/rehype plugin is just a function that receives the `options` and returns a `transformer` that operates on the AST. +For example, let's make a plugin that visits every `h2` heading and adds a `Section X. ` prefix. First, create your plugin source file anywhere—you can even publish it as a separate npm package and install it like explained above. We would put ours at `src/remark/section-prefix.js`. A remark/rehype plugin is just a function that receives the `options` and returns a `transformer` that operates on the AST. ```js "src/remark/section-prefix.js" const visit = require('unist-util-visit'); diff --git a/website/versioned_docs/version-2.0.0-beta.18/guides/markdown-features/markdown-features-tabs.mdx b/website/versioned_docs/version-2.0.0-beta.18/guides/markdown-features/markdown-features-tabs.mdx index 062a9abe54..e5364735ff 100644 --- a/website/versioned_docs/version-2.0.0-beta.18/guides/markdown-features/markdown-features-tabs.mdx +++ b/website/versioned_docs/version-2.0.0-beta.18/guides/markdown-features/markdown-features-tabs.mdx @@ -142,13 +142,13 @@ You may want choices of the same kind of tabs to sync with each other. For examp // highlight-next-line Use Ctrl + C to copy. - Use Command + C to copy. + Use Command + C to copy. // highlight-next-line Use Ctrl + V to paste. - Use Command + V to paste. + Use Command + V to paste. ``` @@ -156,12 +156,12 @@ You may want choices of the same kind of tabs to sync with each other. For examp Use Ctrl + C to copy. - Use Command + C to copy. + Use Command + C to copy. Use Ctrl + V to paste. - Use Command + V to paste. + Use Command + V to paste.
@@ -174,7 +174,7 @@ For all tab groups that have the same `groupId`, the possible values do not need I am Windows. - + I am macOS. @@ -187,7 +187,7 @@ For all tab groups that have the same `groupId`, the possible values do not need I am Windows. - I am macOS. + I am macOS. I am Linux. @@ -201,7 +201,7 @@ Tab choices with different group IDs will not interfere with each other: // highlight-next-line Windows in windows. - macOS is macOS. + macOS is macOS. // highlight-next-line @@ -215,7 +215,7 @@ Tab choices with different group IDs will not interfere with each other: Windows in windows. - macOS is macOS. + macOS is macOS. diff --git a/website/versioned_docs/version-2.0.0-beta.18/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-2.0.0-beta.18/i18n/i18n-crowdin.mdx index bed65e157e..60afe1f10b 100644 --- a/website/versioned_docs/version-2.0.0-beta.18/i18n/i18n-crowdin.mdx +++ b/website/versioned_docs/version-2.0.0-beta.18/i18n/i18n-crowdin.mdx @@ -182,7 +182,7 @@ You should **not commit** it, and it may be a good idea to create a dedicated ** This tutorial uses the CLI version `3.5.2`, but we expect `3.x` releases to keep working. -Install the Crowdin CLI as an NPM package to your Docusaurus site: +Install the Crowdin CLI as an npm package to your Docusaurus site: ```bash npm2yarn npm install @crowdin/cli@3 @@ -468,7 +468,7 @@ module.exports = { if (locale !== DefaultLocale) { return `https://crowdin.com/project/docusaurus-v2/${locale}`; } - // Link to Github for English docs + // Link to GitHub for English docs return `https://github.com/facebook/docusaurus/edit/main/website/${versionDocsDirPath}/${docPath}`; }, // highlight-end diff --git a/website/versioned_docs/version-2.0.0-beta.18/i18n/i18n-tutorial.md b/website/versioned_docs/version-2.0.0-beta.18/i18n/i18n-tutorial.md index 477b89d5af..3d20fa3d86 100644 --- a/website/versioned_docs/version-2.0.0-beta.18/i18n/i18n-tutorial.md +++ b/website/versioned_docs/version-2.0.0-beta.18/i18n/i18n-tutorial.md @@ -437,7 +437,7 @@ On your [static hosting provider](../deployment.mdx): :::caution -This strategy is **not possible** with Github Pages, as it is only possible to **have a single deployment**. +This strategy is **not possible** with GitHub Pages, as it is only possible to **have a single deployment**. ::: diff --git a/website/versioned_docs/version-2.0.0-beta.18/typescript-support.md b/website/versioned_docs/version-2.0.0-beta.18/typescript-support.md index 13f6ad5715..25c36c2c59 100644 --- a/website/versioned_docs/version-2.0.0-beta.18/typescript-support.md +++ b/website/versioned_docs/version-2.0.0-beta.18/typescript-support.md @@ -7,7 +7,7 @@ Docusaurus is written in TypeScript and provides first-class TypeScript support. ## Initialization {#initialization} -Docusaurus supports writing and using TypeScript theme components. If the init template provides a Typescript variant, you can directly initialize a site with full TypeScript support by using the `--typescript` flag. +Docusaurus supports writing and using TypeScript theme components. If the init template provides a TypeScript variant, you can directly initialize a site with full TypeScript support by using the `--typescript` flag. ```bash npx create-docusaurus@latest my-website classic --typescript @@ -104,7 +104,7 @@ module.exports = config; Type annotations are very useful and help your IDE understand the type of config objects! -The best IDEs (VSCode, WebStorm, IntelliJ...) will provide a nice auto-completion experience. +The best IDEs (VS Code, WebStorm, IntelliJ...) will provide a nice auto-completion experience. :::