Skip to content

Updated Portuguese translations - #606

Merged
Aarrayy merged 1 commit into
CachyOS:nextfrom
cantosun99:pt
Aug 8, 2026
Merged

Updated Portuguese translations#606
Aarrayy merged 1 commit into
CachyOS:nextfrom
cantosun99:pt

Conversation

@cantosun99

@cantosun99 cantosun99 commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

Updating languages with local AI: Portuguese

As discussed in Issue #550 I will be starting to AI-translate the languages that don't have anyone translating them by hand like I'm doing with the German one. As most of the existing translations are done by AI anyway, this will just be an update, rather than a step back in quality.

This is the second language by priority after Russian. Next I'll do Spanish, after that Chinese since you might argue Chinese is more important, but that's a whole new language so updating Russian, Portuguese and Spanish is first on my priority.

I ran the wiki page local with bun and while I obviously can't verify the translation itself, I always try to verify if the site is visually identical to the English one to spot syntax errors and if things are or aren't translated.

As I have strong critical opinions on AI-use myself, I want the process to be ran on local hardware and as transparent as possible, which is why I'm listing prompt, model, soft- and hardware that were used. Feel free to suggest any changes or request any clarification of my approach.

Prompt used:

"Today we are going to translate technical documentation for the CachyOS wiki (Arch-based Linux distro).

TRANSLATION RULES:

TRANSLATE:

  • Body text and explanatory content
  • Headings, titles, section labels
  • UI labels (TabItem labels, button text, etc.)
  • Link display text (visible text, not the URL itself)
  • Explanatory comments (in code blocks and around terminal output)

DO NOT TRANSLATE:

  • Actual commands and code
  • Terminal output
  • Program/package/file names and paths (pacman, gcc, /etc/pacman.conf, etc.)
  • URLs
  • Technical terms (bootloader, kernel, PGO, LTO, BOLT, etc.)
  • External link URLs

GOAL: Translate the context so a native reader understands what to do, without over-translating. Users are expected to know basic Linux concepts by their English names.

INTERNAL LINKS: English files live at /src/content/docs/.mdx, translations at /src/content/docs//.mdx. When a link points to another wiki page, add the language code (e.g., /ru/installation/...) so users stay on the translated site. External links stay unchanged.

UPDATING EXISTING TRANSLATIONS:

  • Translated pages usually exist but are outdated; keep existing translation for unchanged content
  • Apply all differences from English: add new content, remove deleted content, update changed content
  • Minimal changes only; do not rewrite unchanged sections
  • Match English formatting EXACTLY: same line breaks, same punctuation marks (' stays ', not ` or "), same spacing

Now, translate/update the English file <path/to/English/file> to Portuguese at <path/to/Portuguese/file>."

Model used:

A Qwen3.6 27B finetune at Q6_K with Q8_0 KV-cache

Software used:

My own AUR packages llama.cpp-sycl and intel-deep-learning-essentials to run the model, Pi Coding Agent as the harness, running on CachyOS of course

Hardware used:

Sparkle Intel Arc Pro B70 with 32GB VRAM

@Aarrayy
Aarrayy merged commit 9893e7e into CachyOS:next Aug 8, 2026
@cantosun99
cantosun99 deleted the pt branch August 8, 2026 20:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants