Skip to content

Improving C# documentation for Internationalizing games #12477

Open

Description

@Heretic717

Your Godot version:
4.7.2

Issue description:
The C# documentation on implementing translation behavior is incomplete in some places and incorrect in others:

  • Automatically setting a language is missing a C# example
  • the code example given for Converting keys to text does not produce the expected result because string interpolation is evaluated before Object.Tr(). I suggest changing the snippet to status.Text = string.format(Tr("GAME_STATUS_{0}"), statusIndex); as this will produce the desire behavior and brings it in line with later examples. This was a misinterpretation of the code on my part. This code example has been clarified with comments.
  • the Placeholders section is missing a C# example and the guidance provided in the explanation is vague. I suggest swapping "equivalent feature" for "string.Format()".

URL to the documentation page (if already existing):
https://docs.godotengine.org/en/stable/tutorials/i18n/internationalizing_games.html

Activity

  1. Heretic717 commented on Oct 29, 2026

    @Heretic717
    Author

    created a PR for my suggested changes:
    #12478 (comment)

  2. added
    area:manualIssues and PRs related to the Manual/Tutorials section of the documentation
    topic:i18nRelated to internationalization.
    on Oct 30, 2026
  3. Calinou commented on Oct 30, 2026

    @Calinou
    Member

    Reopening, as the issue is still not addressed on master currently. The issue can be closed automatically once the PR is merged by linking it with a "closes #xxxx" text in the pull request description.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:manualIssues and PRs related to the Manual/Tutorials section of the documentationbugtopic:dotnettopic:i18nRelated to internationalization.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions