Skip to content

i18n(fr): add French translations 2026-05-04 - #5328

Merged
leaanthony merged 5 commits into
masterfrom
i18n/fr-2026-05-04
May 6, 2026
Merged

leaanthony merged 5 commits into
masterfrom
i18n/fr-2026-05-04

Conversation

@leaanthony

@leaanthony leaanthony commented May 4, 2026 •

Copy link
Copy Markdown
Member

Summary

Automated translation update for French (fr) documentation.

  • Files translated: 5
  • Translation model: qwen3.6:35b (Ollama)
  • Date: 2026-05-04
  • Branch: i18n/fr-2026-05-04

QA Scores

Metric Value
Average Score 0.960
Files Scored 5

Files Requiring Review (score < 0.75)

None ✅

All File Scores

File Score Notes
getting-started/installation.mdx 1.000
index.mdx 0.900 Code block 1 content was modified
quick-start/next-steps.mdx 1.000
quick-start/why-wails.mdx 0.900 Code block 1 content was modified
status.mdx 1.000

Generated by Wails Doc Translator agent (automated weekly i18n run)

Summary by CodeRabbit

  • Documentation
    • French language documentation is now available, including:
      • Installation guide with platform-specific setup instructions
      • Home page with quick start examples and feature overview
      • Getting started guides for next steps after initial setup
      • Project status and roadmap information
      • Comprehensive feature comparison and performance benefits documentation

Automated translation run via Wails Doc Translator agent.
Files: 5
Date: 2026-05-04
Copilot AI review requested due to automatic review settings May 4, 2026 00:16
@coderabbitai

coderabbitai Bot commented May 4, 2026 •

Copy link
Copy Markdown
Contributor

Warning

Rate limit exceeded

@leaanthony has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 3 minutes and 43 seconds before requesting another review.

To keep reviews running without waiting, you can enable usage-based add-on for your organization. This allows additional reviews beyond the hourly cap. Account admins can enable it under billing.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 2e3b46c4-4c6a-40fd-8cc7-1cacf443f033

📥 Commits

Reviewing files that changed from the base of the PR and between 59808e6 and 2c1a792.

📒 Files selected for processing (2)
  • docs/src/content/docs/fr/index.mdx
  • docs/src/content/docs/fr/quick-start/why-wails.mdx

Walkthrough

This PR introduces a complete French language documentation localization for Wails, adding five new MDX documentation pages covering homepage, getting started instructions, feature overview, next steps guidance, and project status, along with translation cache metadata.

Changes

French Documentation Localization

Layer / File(s) Summary
Landing Page
docs/src/content/docs/fr/index.mdx
French homepage with quick-start tabs (macOS/Windows/Linux), feature cards ("Why Wails?"), next steps links, alpha status note, and sponsorship call-to-action. Includes inline CSS for hero animations and gradient overlays.
Why & How Wails
docs/src/content/docs/fr/quick-start/why-wails.mdx
French "Why Wails?" page explaining performance benefits, developer experience, production readiness, use cases, and architecture comparison with Electron. Includes a d2 diagram and success stories.
Installation Guide
docs/src/content/docs/fr/getting-started/installation.mdx
French installation documentation covering supported platforms, common dependencies (Go, npm), platform-specific prerequisites via tabs, CLI installation methods (stable and dev), system verification with wails3 doctor, and troubleshooting for missing command.
Next Steps & Resources
docs/src/content/docs/fr/quick-start/next-steps.mdx
French "Next steps" page directing readers toward TODO CRUD tutorial, feature list (Windows, Menus, Dialogs, Bindings, Clipboard, Drag-and-drop, Keyboard), and support resources (Discord, examples, API reference).
Project Status
docs/src/content/docs/fr/status.mdx
French roadmap page documenting current Alpha status, contributing guidance (testing, documentation, discussions, pull requests), and explanation of how feedback shapes milestones.
Translation Infrastructure
docs/.translation-cache/fr.json
Translation cache entries for five French documentation files with hash and translated_at timestamp metadata.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Poem

🐰 Un français pour chaque page,
Bienvenue sur notre étage!
Installation, statut, et pourquoi,
Tous les chemins menent à soi.
Wails grandit dans nos cœurs—allons créer! 🌟

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The PR description omits required template sections (Type of change checkboxes, Testing details, Test Configuration, and Checklist items), though it provides automated translation metadata. Complete the description template by adding Type of change selection, testing verification details, wails doctor output, and checklist confirmations.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly describes the main change: adding French translations for documentation files on the specified date.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch i18n/fr-2026-05-04

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
Review rate limit: 0/8 reviews remaining, refill in 3 minutes and 43 seconds.

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/src/content/docs/fr/getting-started/installation.mdx`:
- Around line 67-73: Replace the old command string "wails doctor" with "wails3
doctor" throughout the installation guide so the v3 docs are consistent;
specifically update the occurrences inside the Windows and Linux TabItem blocks
(the lines referencing the command in the Windows and Linux sections) and verify
there are no remaining "wails doctor" tokens elsewhere (search for "wails
doctor" and ensure every match becomes "wails3 doctor").

In `@docs/src/content/docs/fr/index.mdx`:
- Around line 15-16: The CTA with label "Commencer" currently points to the old
route '/quick-start/installation'; update the link value for the entry with
text: Commencer to '/getting-started/installation' so it routes to the newly
added French installation page (match the existing route used by
installation.mdx).

In `@docs/src/content/docs/fr/quick-start/why-wails.mdx`:
- Around line 121-123: In the docs/src/content/docs/fr/quick-start/why-wails.mdx
file, update the "Guide d'installation →" link target from
"/quick-start/installation" to the translated path
"/getting-started/installation" so the "Prochaines étapes" link points to the
correct translated installation page.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 54ad6895-df50-43f1-9225-ee2f674528f2

📥 Commits

Reviewing files that changed from the base of the PR and between 771fe1c and 59808e6.

📒 Files selected for processing (6)
  • docs/.translation-cache/fr.json
  • docs/src/content/docs/fr/getting-started/installation.mdx
  • docs/src/content/docs/fr/index.mdx
  • docs/src/content/docs/fr/quick-start/next-steps.mdx
  • docs/src/content/docs/fr/quick-start/why-wails.mdx
  • docs/src/content/docs/fr/status.mdx

Comment on lines +67 to +73
Wails nécessite que le [WebView2 Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/) soit installé. La quasi-totalité des installations Windows ont déjà ce runtime installé. Vous pouvez vérifier cela avec la commande `wails doctor`.

</TabItem>
<TabItem label="Linux" icon="linux">

Linux nécessite les outils de compilation `gcc` standards ainsi que `gtk3` et `webkit2gtk`. Exécutez <code>wails doctor</code> après l'installation pour voir comment installer les dépendances. Si votre distribution ou gestionnaire de paquets n'est pas pris en charge, veuillez nous en informer sur Discord.

@coderabbitai coderabbitai Bot May 4, 2026 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Use wails3 doctor consistently in this v3 installation guide.

Line [67] and Line [72] reference wails doctor, but Line [99] correctly uses wails3 doctor. The older command in these steps can mislead users and break verification flow.

💡 Suggested fix
-    Wails nécessite que le [WebView2 Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/) soit installé. La quasi-totalité des installations Windows ont déjà ce runtime installé. Vous pouvez vérifier cela avec la commande `wails doctor`.
+    Wails nécessite que le [WebView2 Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/) soit installé. La quasi-totalité des installations Windows ont déjà ce runtime installé. Vous pouvez vérifier cela avec la commande `wails3 doctor`.

-    Linux nécessite les outils de compilation `gcc` standards ainsi que `gtk3` et `webkit2gtk`. Exécutez <code>wails doctor</code> après l'installation pour voir comment installer les dépendances. Si votre distribution ou gestionnaire de paquets n'est pas pris en charge, veuillez nous en informer sur Discord.
+    Linux nécessite les outils de compilation `gcc` standards ainsi que `gtk3` et `webkit2gtk`. Exécutez <code>wails3 doctor</code> après l'installation pour voir comment installer les dépendances. Si votre distribution ou gestionnaire de paquets n'est pas pris en charge, veuillez nous en informer sur Discord.

Also applies to: 99-99

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/src/content/docs/fr/getting-started/installation.mdx` around lines 67 -
73, Replace the old command string "wails doctor" with "wails3 doctor"
throughout the installation guide so the v3 docs are consistent; specifically
update the occurrences inside the Windows and Linux TabItem blocks (the lines
referencing the command in the Windows and Linux sections) and verify there are
no remaining "wails doctor" tokens elsewhere (search for "wails doctor" and
ensure every match becomes "wails3 doctor").

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ℹ️ Source bug — wails doctor on lines 72/73 comes from the English source.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@leaanthony, thanks for confirming — this is consistent with the pattern already in my knowledge base (flagging wails doctor in translated docs as a likely upstream English source bug). The fix should be applied to the English source installation.mdx so all future translations pick up wails3 doctor correctly.

Would you like me to open a GitHub issue to track fixing the English source file(s) that still contain wails doctor instead of wails3 doctor? I can search for all occurrences across the English docs and include them in the issue body.


🧠 Learnings used
Learnt from: popaprozac
Repo: wailsapp/wails PR: 4839
File: docs/src/content/docs/reference/window.mdx:616-620
Timestamp: 2025-12-29T08:02:06.122Z
Learning: In Wails v3, document window creation using app.Window.New() and app.Window.NewWithOptions(...). Do not show or reference app.NewWebviewWindow() or app.NewWebviewWindowWithOptions(...). The Application struct exposes a Window field of type *WindowManager that provides these methods. When updating docs, replace examples accordingly and mention that WindowManager methods create and configure new windows.

Learnt from: leaanthony
Repo: wailsapp/wails PR: 5326
File: docs/src/content/docs/ko/getting-started/installation.mdx:67-72
Timestamp: 2026-05-04T12:19:38.974Z
Learning: When reviewing Wails documentation (including translated MDX pages), Wails v3 CLI commands must use the `wails3` prefix. For example, the correct command for the doctor check is `wails3 doctor` (not `wails doctor`). If a translated doc contains `wails doctor`, treat it as a likely bug in the English source content rather than a translation/localization mistake, and report it back to the docs source.

Comment thread docs/src/content/docs/fr/index.mdx Outdated
Comment thread docs/src/content/docs/fr/quick-start/why-wails.mdx

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds a first batch of French-language documentation pages under docs/src/content/docs/fr as part of the automated i18n workflow for the v3 docs site. It extends the docs content tree with French versions of the homepage, quick-start pages, status page, and an installation guide, plus the translation cache entry used by the translation pipeline.

Changes:

  • Add French translations for the docs homepage, roadmap/status page, and quick-start content.
  • Add a French installation guide and corresponding translation-cache metadata.
  • Mirror selected English docs content into the new fr/ subtree for localized browsing.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
docs/src/content/docs/fr/status.mdx Adds a French translation of the project status / roadmap page.
docs/src/content/docs/fr/quick-start/why-wails.mdx Adds a French translation of the “Why Wails?” quick-start page.
docs/src/content/docs/fr/quick-start/next-steps.mdx Adds a French translation of the quick-start “Next Steps” page.
docs/src/content/docs/fr/index.mdx Adds a French translation of the docs landing page.
docs/src/content/docs/fr/getting-started/installation.mdx Adds a French installation guide under the getting-started subtree.
docs/.translation-cache/fr.json Records translation hashes/timestamps for the French docs batch.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Tutoriel première application →](/quick-start/first-app)

3. **Explorer les fonctionnalités** - Découvrez ce que Wails peut faire pour votre application
[Aperçu des fonctionnalités →](/quick-start/next-steps)

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Fixed — next-steps link now points to /fr/quick-start/next-steps.

@@ -0,0 +1,106 @@
---
title: Installation
description: Installez Wails et configurez votre environnement de développement

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔄 Structural — File mirrors source path. CTA updated to point to the translated page.

Wails nécessite plusieurs dépendances communes avant l'installation :

<Tabs>
<TabItem label="Go (au moins 1.24)" icon="seti:go">

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ℹ️ Source bug — English source says Go (At least 1.24).

Comment on lines +67 to +72
Wails nécessite que le [WebView2 Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/) soit installé. La quasi-totalité des installations Windows ont déjà ce runtime installé. Vous pouvez vérifier cela avec la commande `wails doctor`.

</TabItem>
<TabItem label="Linux" icon="linux">

Linux nécessite les outils de compilation `gcc` standards ainsi que `gtk3` et `webkit2gtk`. Exécutez <code>wails doctor</code> après l'installation pour voir comment installer les dépendances. Si votre distribution ou gestionnaire de paquets n'est pas pris en charge, veuillez nous en informer sur Discord.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ℹ️ Source bug — wails doctor from English source.

Comment on lines +67 to +72
Wails nécessite que le [WebView2 Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/) soit installé. La quasi-totalité des installations Windows ont déjà ce runtime installé. Vous pouvez vérifier cela avec la commande `wails doctor`.

</TabItem>
<TabItem label="Linux" icon="linux">

Linux nécessite les outils de compilation `gcc` standards ainsi que `gtk3` et `webkit2gtk`. Exécutez <code>wails doctor</code> après l'installation pour voir comment installer les dépendances. Si votre distribution ou gestionnaire de paquets n'est pas pris en charge, veuillez nous en informer sur Discord.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ℹ️ Source bug — Same.


## État actuel : Alpha

Consultez le [Journal des modifications](./changelog) pour connaître l'état d'avancement le plus récent.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ℹ️ Known limitation — fr/changelog.mdx not in this batch.

Comment thread docs/src/content/docs/fr/index.mdx Outdated
alt: Logo Wails
actions:
- text: Commencer
link: /quick-start/installation

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Fixed — Hero CTA updated to /fr/getting-started/installation.

Maintenant que vous comprenez ce que Wails offre, mettons-le en place :

1. **Installer Wails** - Configurez votre environnement de développement en 5 minutes
[Guide d'installation →](/quick-start/installation)

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Fixed — Install link updated to /fr/getting-started/installation.

@leaanthony
leaanthony merged commit a28f647 into master May 6, 2026
16 checks passed
@leaanthony
leaanthony deleted the i18n/fr-2026-05-04 branch May 6, 2026 12:43
pull Bot pushed a commit to WangNingkai/wails that referenced this pull request May 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants