General Notes

• English texts are the single source of truth. When you think something is missing / unclear, propose this change in the English texts first, do not change things in individual translations.
• For vanilla Minecraft terms (Redstone, Hopper, Chest, …), use the official Minecraft translation for your language.
• Use the same name for an item or block everywhere: in item names, tooltips and the manual.
• Puns and references (for example "Scrench" or image captions like "Random Access Memories") may be adapted freely. A translation that works in your language is better than a literal one.
• Translations marked "Needs editing" are never shipped. Until a string is translated and confirmed, the game shows the English text.

Strings

These are item names, tooltips and other user interface texts, used with Minecraft's builtin translation system. The context shown with each string is its translation key.

• Keep %s placeholders. If your language needs a different order, use numbered placeholders such as %1$s and %2$s. Use %% for a literal percent sign.
• Strings with keys ending in .desc are item tooltips. Depending on the game version and mod setup, these are shown on a single line. Keep them about as short as the English.
• For item and block names, use the capitalization rules of your language. English uses title case.

Manual

Each string is exactly one line of a manual page. The page is shown as the string's location.

• Do not add line breaks. The manual wraps long lines automatically.
• Keep placeholders such as ({1}). They become link and image targets. Translate the text in brackets, [like this]({1}) and ![like this]({1}), but keep the brackets and the placeholder directly after it. You may move links within the sentence. The number decides which target is used.
• Text in ![...] is the tooltip of an image.
• Keep text in backticks unchanged: code, commands, file names, method signatures such as getLevels():number.
• Supported formatting: **bold**, *italic*, ~~strikethrough~~, `code`. Write a lone * or _ in backticks, otherwise it may turn text into italics.
• Do not add # or - at the start of a line. Headings and list markers are kept automatically.
• To see a line in context, open the page on GitHub: common/src/main/resources/assets/oc2/doc/en_us/<page>, or for device pages common/src/generated/resources/assets/oc2/doc/en_us/<page>.