Skip to content

Commit 92febaf

Browse files
committed
Add reviewer feedback ✨
1 parent 32f5d8d commit 92febaf

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

translations.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -74,12 +74,12 @@ We recommend promptly reviewing and merging translation pull requests so that yo
7474

7575
## Writing content to be translated
7676

77-
To make your documentation more translatable and easier to read in English, avoid these common patterns.
77+
To make your documentation more translatable and easier to read in English, **avoid** these common patterns:
7878

7979
* **Wordiness**: Redundant sentences are more difficult to comprehend and translate.
8080
* **Avoid**: "In order to be able to successfully complete the installation process..."
8181
* **Better**: "To install the software..."
82-
* **Passive voice**: Active voice makes your instructions more clear and translatable.
82+
* **Passive voice**: Passive voice makes it unclear who performs an action.
8383
* **Avoid**: "The configuration file should be updated by the administrator."
8484
* **Better**: "The administrator should update the configuration file."
8585
* **Negative sentences**: Tell people what to do rather than what not to do.

0 commit comments

Comments
 (0)