docs: add warning for globbing in i18n tutorial (#11158) #11450
+6
−0
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Title : docs: add warning for
cp -r
globbing in i18n tutorial (#11158)Pre-flight checklist
Motivation
This PR addresses issue #11158, which describes an unexpected behavior when using
cp -r docs/** i18n/fr/docusaurus-plugin-content-docs/current
in the i18n tutorial. In some shell configurations (specifically those with globstar enabled), this command leads to duplicate files in the destination directory because the shell first globs all files and then recursively copies each one individually.To help users understand and mitigate this issue, a warning message has been added to the i18n tutorial documentation.
Test Plan
To verify this change, you can:
website/docs/i18n/i18n-tutorial.mdx
file (or its rendered equivalent in the deploy preview).cp -r
command block under "Translate the docs" section.Test links
Deploy preview: https://deploy-preview-_____--docusaurus-2.netlify.app/
(Once the Netlify deploy preview is available, please update this link to point to the
i18n-tutorial.mdx
page.)Related issues/PRs
Closes #11158